READ ME FIRST 


All computer software is subject to change, correction, or improvement as the manu- 
facturer receives customer comments and experiences. Radio Shack has estab- 
lished a system to keep you immediately informed of any reported problems with 
this software, and the solutions. We have a customer service network including rep- 
resentatives in many Radio Shack Computer Centers, and a large group in Fort 
Worth, Texas, to help with any specific errors you may find in your use of the pro- 
grams. We will also furnish information on any improvements or changes that are 
“cut in” on later production versions. 


To take advantage of these services, you must do three things: 

(1) Send in the postage-paid software registration card included in this manual 
immediately. (Postage must be affixed in Canada.) 

(2) If you change your address, you must send us a change of address card 
(enclosed), listing your old address exactly as it is currently on file with us. 

(3) As we furnish updates or “patches”, and you update your software, you must 
keep an accurate record of the current version numbers on the logs below. 

(The version number will be furnished with each update.) 

Keep this card in your manual at all times, and refer to the current version numbers 

when requesting information or help from us. Thank you. 


APPLICATIONS SOFTWARE 
VERSION LOG 

01 . 00.00 


OP. SYSTEM 
VERSION LOG 


800-0147-00 
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In order for us to notify you of modifications or updates to this program you MUST 
complete this card and return it immediately. This card gets you information only and 
is NOT a warranty registration. Register one software package per card only. The 
registration card is postage paid— it costs you nothing to mail. 

Two change of address cards have been included so that you may continue to re- 
ceive information in the event that you move. Copy all address information from the 
Registration Card onto them prior to sending the Registration Card. They must show 
your “old address” exactly as you originally registered it with us. 
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Changes and Corrections 

This Changes and Corrections page contains changes and correc- 
tions to the TK! Solver® Instruction Manual. 

Page 5-11 

The last line on the bottom of this page should contain a blue A. 

Page 6-14 

The values on the Variable subsheet are actually rounded to 1 1 
significant digits, not 10 as stated. 

Page 12-17 

The unit for the output value of the variable s should be “mi/h,” 
not “mi/hr.” 

Page 14-2 

After you load munits into the mortgage model, you must re- 
display the Variable Sheet in a single window before saving the 
model. Do not redisplay the Rule Sheet as instructed. 

By supplying these changes and corrections, Software Arts, Inc. 
is neither waiving any of its rights nor expanding the scope of any 
of its obligations under the license agreement for the TK! Solver 
program. 
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Converting to 50HZ Operation 

The TRS-80 Model 4 Operating System (TRSDOS) is designed 
for use with a 60-hertz ac power supply. Some countries use 50- 
hertz ac power. System and applications software purchased 
from Radio Shack are on 60-hertz disks unless marked “50HZ ” 
If you are in a 50-hertz area, you should convert your disks. 
(Note: If you attempt to set your system to the power supply it’s 
already set for, the program will abort. This will not result in any 
problems; it simply means there is no need to go through this pro- 
cedure.) Only the disks that are used in drive 0 need to be con- 
verted. 

To convert disks to 50 hertz, a program called hertz is run. This 
program is on all TRSDOS disks and most application software 
disks. If hertz is not on the disk, either place a TRSDOS disk of 
the same version in drive 1 (multiple-drive system) or copy the 
program from a TRSDOS disk to the application disk (single- 
drive system). Your hardware must have been modified before 
you apply this patch. 

To perform the procedure, do the following: 

• Place the disk to be converted in drive 0. 

• At the prompt “TRSDOS Ready”, type DO = HERTZ. Press 
ENTER. 

• At the prompt for a selection of 5 or 6, type 5 for 50 hertz. If 
you wish to convert to 60 hertz you type 6. 

• Once the patch is applied, the system will automatically reboot 
itself. The disk has now been permanently converted to 50 
hertz. 

• If you copied hertz to the disk, remove it with the command 

REMOVE HERTZ/JCL. 
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READ THIS AGREEMENT CAREFULLY. USE OF 
THIS PRODUCT CONSTITUTES YOUR ACCEP- 
TANCE OF THE TERMS AND CONDITIONS OF 
THIS AGREEMENT. 

LIMITED WARRANTY 

This Software program is licensed on an "AS IS" 
basis, without warranty. The original CUSTOMER'S 
exclusive remedy, in the event of a manufacturing 
defect in the diskette, is its repair or replacement 
within thirty (30) calendar days of the date of the 
Radio Shack sales document received upon the li- 
cense of the Software The defective diskette shall 
be returned to a Radio Shack Computer Center, a 
Radio Shack retail store, participating Radio Shack 
franchisee or Radio Shack dealer along with the 
sales document. 

EXCEPT AS PROVIDED HEREIN, RADIO SHACK 
AND SOFTWARE ARTS, INC. MAKE NO EX- 
PRESS WARRANTIES, AND ANY IMPLIED WAR- 
RANTYOF MERCHANTABILITY OR FITNESS FOR 
A PARTICULAR PURPOSE IS LIMITED IN ITS DU- 
RATION TO THE DURATION OF THE WRITTEN 
LIMITED WARRANTIES SET FORTH HEREIN. 

Some states do not allow limitations on how long an 
implied warranty lasts, so the above limitation (s) 
may not apply to CUSTOMER. 

DISCLAIMER OF LIABILITY 

RADIO SHACK AND SOFTWARE ARTS, INC. 
SHALL HAVE NO LIABILITYOR RESPONSIBILITY 
TO CUSTOMER OR ANYOTHER PERSON OR EN- 
TITY WITH RESPECT TO ANY LIABILITY, LOSS 
OR DAMAGE CAUSED OR ALLEGED TO BE 
CAUSED DIRECTLY OR INDIRECTLY BY "SOFT- 
WARE" LICENSED OR FURNISHED BY RADIO 
SHACK AND/OR SOFTWARE ARTS. INC., IN- 
CLUDING, BUT NOT LIMITED TO, ANY INTER- 
RUPTION OF SERVICE, LOSS OF BUSINESS OR 
ANTICIPATORY PROFITS OR INDIRECT, SPECIAL 
OR CONSEQUENTIAL DAMAGES. 

Some states do not allow the limitation or exclusion 
of consequential damages, so the above lim- 
itation(s) or exclusion(s) may not apply to 
CUSTOMER. 


SOFTWARE LICENSE 

RADIO SHACK and SOFTWARE ARTS, INC. grant 
to CUSTOMER a non-exclusive, paid-up license to 
use this Software on one computer subject to the 
following provisions: 

A. Except as otherwise provided in this Software 
License, applicable copyright laws shall apply to the 
Software. 

B. Title to the medium on which the Software is re- 
corded (diskette) is transferred to CUSTOMER, but 
not title to the Software. 

C. CUSTOMER shall not use, make, manufacture 
or reproduce copies of the Software except for use 
on one computer and except as is specifically pro- 
vided in this Software License. CUSTOMER is ex- 
pressly prohibited from disassembling the 
Software. 

D. CUSTOMER is permitted to make six additional 
copies of the Software only for back-up or archival 
purposes or if such additional copies are required in 
the operation of one computer with the Software, 
but only to the extent the Software documentation 
allows back-up copies to be made. 

E. All copyright notices shall be retained on all 
copies of the Software. 

F. CUSTOMER is permitted to transfer unmodified 
Software and all copies of the Software which have 
been made to a single third party provided CUS- 
TOMER has paid for the Software to be transferred. 
In any event the provisions of this License and War- 
ranty Agreement shall be applicable to a third party 
receiving the Software from CUSTOMER. 

THIS LICENSE AND WARRANTY AGREEMENT 
CONSTITUTES THE ENTIRE AGREEMENT AND 
UNDERSTANDING BETWEEN THE PARTIES AND 
SUPERSEDES ANY PROPOSAL OR PRIOR 
AGREEMENT, ORAL OR WRITTEN, AND ANY 
OTHER COMMUNICATION RELATING TO THE 
SUBJECT MATTER OF THIS AGREEMENT. 

The warranties granted herein give the original 
CUSTOMER specific legal rights, and the original 
CUSTOMER may have other rights which vary from 
state to state. 


800001 2-00-C 
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TKiSolver Introduction 

The TKiSolver® program is an entirely new concept in personal 
computer software. It is a tool for professionals who commonly 
use equations for analysis, design, and planning and who now 
depend on calculators to solve their problems. With just a few 
simple TKiSolver commands you can quickly solve equations, 
convert units of measurement, plot graphs, and make tables. 

Even if you have never used a computer before, in a short time 
you can be using the TKiSolver program to solve problems. You 
can use standard textbook formulas or your own. You can use the 
functions that have been built into the program and you can cre- 
ate your own. Once you have stated your problem, simply enter 
the known values, then solve the problem with a single keystroke. 

This Introduction contains information about the contents of the 
TKiSolver package. The first section tells you what the different 
parts of the package are and how to use each of them. The fol- 
lowing sections give a general overview of the program, how it 
works, and how to use it. 

The TKiSolver Package 

This package contains your TKiSolver program and many pieces 
of documentation, including important license information. We 
have included a wide range of documentation because we want to 
accommodate all users of the TKiSolver program, whatever their 
experience with personal computers. You may want to use all of 
the documentation or only part of it. 

We recommend that everyone read the Introductory Guide first. 
It will quickly acquaint you with the TKiSolver program so that 
you can begin using it right away. 

Your TKiSolver package contains: 

In the binder, separated by dividers: 

• Introductory Guide 

• Introduction (what you are reading now) 

• Instruction Manual 

• Reference Manual (tabbed) 
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In the plastic sleeves: 

• Reference Card 

• The TKiSolver Program Diskette 

• TKiSolver Reference Poster 

• Software Arts Registration Card 


The Introductory Guide 

The Introductory Guide is a sampler of many of the commands 
and features of the TKiSolver program, and we recommend it be 
your first step in learning the program. While you are using the 
program you may find that you understand much of what the 
program is doing, even if you have never used a computer before. 
After looking through the Introductory Guide, you will probably 
be familiar enough with the program to begin using it right away. 
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The Instruction Manual 

The Instruction Manual is a complete tutorial of the TKISolver 
program. Beginning with the essential operating system com- 
mands that you will need to use your personal computer, the In- 
struction Manual moves through a set of instructions designed to 
teach you all the features and commands of the TKISolver pro- 
gram. Many examples are used throughout the manual; some are 
included on the TKISolver program diskette, and some you cre- 
ate as exercises while you work through the manual. 

The Reference Manual 

The Reference Manual, tabbed so that you can easily find what 
you are looking for, is a complete and detailed reference for the 
TKISolver program. The Reference Manual is especially useful 
after you have learned the fundamentals of the program and 
want to understand and explore the implications of the com- 
mands, features, and mathematical powers available. 

The Reference Manual has cross-references, a general program 
description, and detailed descriptions of all the program com- 
mands and features. The Commands section of the manual in- 
cludes a chart of the TKISolver commands. You may want to use 
it as a reference while you are learning the program. The Mathe- 
matics section details the mathematical conventions and solution 
processes of the program. The Hardware Reference section lists 
the specifications and requirements for your computer system. 
Other sections include the Appendices, which contain lists of 
prompts, status messages, and error messages; the Glossary; and 
the Index. 

The Reference Card 

The Reference Card is a brief review of the commands and major 
features of the program. Once you are familiar with the program, 
you will probably want to keep the Reference Card beside your 
computer while you are working. 

The Program Diskette 

Your TKISolver package includes one diskette which contains the 
complete TKISolver program. The diskette also contains all of 
the TRS-80® Model 4 files needed to boot the operating system 
(TRSDOS®). 
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You may make six backup copies of the TK!Solver program and 
one backup copy on a hard disk for use on a single computer. Any 
other copying of the program diskette or individual TKISolver 
files is a violation of copyright law and the TKISolver license 
agreement. 

The TKISolver Reference Poster 

The Reference Poster graphically displays the TKISolver com- 
mands and sheets and lists the built-in functions. 

The Software Arts Registration Card 

When you fill out and send in the Software Arts Registration 
Card, you will receive a sample issue of SATN®, the journal for 
users of Software Arts programs. It is intended to help you make 
more effective use of those programs through tips, tutorials, and 
examples of practical applications. 

What the TKISolver Program Does 

The TKISolver program helps you solve problems in just a few 
easy steps: 

1 \ • Formulate the problem as a TKISolver model. A 

TKISolver model poses a problem using sets of equa- 
tions to define the relationships among variables. 

• Enter the model in the TKISolver program. 

• Enter the known values. 

0 • Type the Action command (I). 

The TKISolver program solves for as many unknown values as it 
can determine. 

Once you have created your model, you can solve a variety of 
problems, depending on the values known. If the program can- 
not solve a model, it displays messages to help you diagnose the 
reason. 

Although this version of the program cannot easily do matrix op- 
erations or numerical techniques for integration, and is unable to 
do symbolic calculus, it can find real-number solutions for most 
sets of algebraic equations. 
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How the TKISolver Program Works 

Before you begin using the TKISolver program, you may find it 
helpful to know a little about the structure of the program and 
how it works. 

If you were writing down problems to be solved, you would use a 
sheet of paper. In the program, sheets of paper are replaced by 
TKISolver sheets, the screen displays where you record your 
model. When you have created a model by entering information 
on the sheets, you type the Action command (!) and use one of 
the program’s solvers, mechanisms used by the program to do 
calculations, to solve for unknown variable values. 

Altogether, there are eight sheets in the program, each containing 
different information. A model could use all of them or only two. 
The amount of information you provide depends on your model. 

These are the TKISolver sheets: 

• The Rule Sheet contains the equations that define the model. 

• The Variable Sheet contains all the variables with their charac- 
teristics, such as units and values. 

• The Unit Sheet defines conversions between units of measure- 
ment. 

• The Global Sheet sets limits and requirements for the program, 
the solvers, and your printer. 

• The List Sheet contains all the lists of values in the model. 

• The User Function Sheet contains all the functions you have 
created. 

• The Plot Sheet contains the information needed to plot a graph 
of values. 

• The Table Sheet contains the information needed to produce a 
table of values. 

In addition, you can look at more information by displaying sub- 
sheets. The three kinds of subsheets show details about variables, 
lists, and functions created by the user. 
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When you are using the TKiSolver program, you can do several 
things. You can type and enter information to create a model; you 
can load a model from a diskette; and you can type TKiSolver 
commands to manipulate the sheets and the information on 
them. The TKiSolver program has an Editor, which enables you 
to change your model easily, and an online Help Facility for in- 
formation about commands and features. 

DIF 

The TKiSolver program supports the DIF™ format, a standard 
storage format developed by Software Arts that enables different 
programs to exchange data. 

Conclusion 

Now that you have some idea of what the TKiSolver program is 
about, it’s time to start using it. If you haven’t read the Introduc- 
tory Guide, we recommend you do so before going any further. 
In just a short time, you will find that the TKiSolver program is 
the most useful problem-solving tool you’ve ever used. 
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Part I Introduction 

This manual guides you through a step-by-step process designed 
to teach you how to use the TK! Solver® program. As you work 
through the chapters, you will learn how to use the TK! Solver 
commands to build, refine, and solve many TK! Solver models. 
When you finish this manual, you will have used all the features 
of the TK! Solver program and applied them to sample models. 

A TK! Solver model formulates a problem using sets of equations 
to define the relationships among variables. TK! Solver models 
give you the facility not only to solve problems, but also to plot 
graphs, build tables, and define your own functions. 

If you have read through the Introductory Guide, you have some 
familiarity with the program and what it does. If you have not 
gone through the Introductory Guide, you may want to do so be- 
fore beginning to explore in depth the many features of the pro- 
gram. 

This manual is divided into four parts. 

• Part I, Introduction, is a guide to using the Instruction Manual 
and your operating system and shows you how to load the pro- 
gram. 

• In Part II, Building and Using a Model, you will begin to use 
the program and build a model. You will use many models as 
examples while you are learning to apply the program, but the 
model that you build in Part II is utilized throughout the man- 
ual. As you learn to use the TK! Solver program, this model 
will be modified and expanded to illustrate applications of all 
the features of the TK! Solver program. 

• Part III, The Solvers, discusses the program’s solution mecha- 
nisms and how to use them. 

• Part IV, Lists, shows you how to create and use lists of values 
for solutions, graphs, and tables, and how to define your own 
functions. 
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• Chapter 1 Using the Instruction Manual 

• Chapter 2 Using Your TRS-80® Model 4 

• Chapter 3 Loading the TKiSolver Program 
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Chapter 1 Using the Instruction Manual 

• The Instruction Manual 

• Glossary 

• Instruction Manual conventions 

This Instruction Manual will show you how to use the TKISolver 
program. As you work through the chapters, you will use all the 
commands and features of the program, applying them to exam- 
ples as you go along. As you become familiar with the TKISolver 
program, you will find more and more ways to exercise the free- 
dom that it gives you to explore mathematical problems. 

The Instruction Manual 

The Instruction Manual is structured to take you through the 
program, from the simpler features to the more complex ones. 
You will actually use each feature, creating and solving workbook 
examples with the program. While you are working, you will use 
an Instruction diskette that you will create in Chapter 3. This 
diskette will contain information that you need for the examples 
and will also give you a place to store the sample models you will 
create. 

While you are learning the program, you may want to use the 
Reference Card as a check list of the commands and features you 
have learned. You may also want to look at the Command Chart 
that is in the Commands section of the Reference Manual. It 
shows the structure of all the TKISolver commands and may be 
an aid while you are learning the commands. 

Listed below are some common terms used in this manual. A 
comprehensive glossary appears in the Reference Manual. 

Glossary 

Boot To b° ot means to load the program called the disk 

operating system, which you use to run other 
programs on your computer. (The word “boot” 
originates from the phrase “pull up by the boot- 
straps.”) 
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Byte 

Command 

Connection 

Cue 

Cursor 

Default 

Device 

Devspec 
DIF File 
Diskette 

Extension 


The memory capacity of a computer is measured 
in units called “bytes.” Your personal computer is 
equipped with a given number of bytes. A kilo- 
byte (IK byte) equals 1024 bytes. 

A command is a keystroke, character, or set of 
characters that tells the program to perform a 
specific task. 

A connection, or device specification, is a two- 
letter abbreviation that you use to identify a piece 
of hardware to the operating system. 

The cue points to the current character position in 
a line of text and is one character wide. It may 
appear inside the cursor. 

The cursor highlights the current position on the 
screen. It may vary in size according to your posi- 
tion on the screen. The cursor shows the screen 
position; the cue shows the position within that 
line. 

A default is the value used or the action per- 
formed by a program if you do not specify any 
other value or action. 

A physical device is a piece of hardware, such as a 
printer. A logical device, or device specification, 
is a two-letter abbreviation that you use to iden- 
tify a physical device to the operating system. 

A devspec is a shorter name for device specifica- 
tion. 

A file using the data interchange format standard 
to permit exchange of data between programs. 

A diskette looks like a small phonograph record 
in a permanent black plastic sleeve. Files are 
stored on it magnetically. When a diskette is in the 
disk drive, the computer can read information 
from it and write information onto it. 

An extension is a suffix for a filename that helps 
identify the contents of the file. Extensions are 
separated from a filename by a slash (/), are one 
to three characters long, and must begin with a 
letter. 
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File 


Filename 

Format 
Hard Disk 


Load 

Model 

Program 

Prompt 

Run 


A file is a collection of information. Files can 
contain groups of numbers, lines of text, or pro- 
grams. Files are stored on either diskettes or hard 
disks. The number of files that may be stored on a 
diskette depends on the size of the files (how 
much information they contain) and how much 
space there is on the diskette. 

A filename is the name used to identify a specific 
file on a diskette or hard disk. Filenames are as- 
signed by either a program or a user. 

To format a diskette is to prepare it magnetically 
to accept information. 

A hard disk is a sealed container that holds an 
aluminum disk coated with a magnetic surface 
that is used to store information. Files are stored 
on it and are read from it in the same way as a 
diskette. The storage capacity of the hard disk, 
however, is much greater than that of a diskette. 
Hard-disk memory storage is represented in me- 
gabytes. A megabyte equals approximately one 
million bytes. 

To load a file is to copy the contents of the file 
from the diskette, where it is stored, to the com- 
puter’s memory, where it can be used. 

Data entered into the TK! Solver program which 
formulates a problem using sets of equations to 
define the relationships among variables. 

A program is a set of instructions for the com- 
puter. These instructions may be in one file or in 
several files. 

A prompt is a message that appears on the screen 
asking for a specific choice or for more informa- 
tion. Before the program can continue, you must 
respond to the prompt by typing the information 
requested. 

To run a program causes the computer to follow 
an instruction or set of instructions. 


1-3 
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Instruction Manual Conventions 


There are several conventions used throughout this text. They are 
designed to help you identify what you are supposed to type and 
when you are supposed to type it. 

• Uppercase and Lowercase Characters 

All commands and filenames in this text are shown in upper- 
case characters. This convention helps you to identify the order 
of the commands and how they should be typed. When you 
type a command or filename in the TKISolver program, you 
can use uppercase or lowercase letters, or a combination of 
both. 

• Symbols 

In the text, symbols are used to indicate special keys and com- 
mands. Table 2-1 in Chapter 2 shows the symbols used in the 
Instruction Manual. 

• Single-Drive and Multiple-Drive Systems 

If instructions are different for single-drive and multiple-drive 
systems, the instructions begin with two lines across the page 
(for two drives) or one line across the page (for one drive) and 
end with a box (□). 

If there are any special directions for a hard disk, they are given 
in a separate section that also ends with a box (t i). 

• Special Type and Color 

In the text, the way the words look tells you what you are sup- 
posed to do. 


/ S L Type as shown. 

For Help, type ? What you see on the computer 
screen. 

extension Enter according to the conventions 

of TRSDOS. 

extension Displayed according to the 

conventions of TRSDOS. 


• Figures 

The screen figures you see in this text may be slightly different 
from what you see on the screen. 
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• Notes 

Throughout the text there are special Notes giving general in- 
formation about the program that will make it easier to use and 
understand. 

The next chapter is about the operating system and some special 
things you should know before you begin to use the TKISolver 
program. 
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Chapter 2 Using Your TRS-80® MODEL 4 

• What you need 

• Cursor 

• Cue 

• Error signal 

• Notes about the keyboard 

• Files, drives, and diskettes 

• Using your computer 

• TRSDOS® programs 

• File-naming conventions 

This chapter describes how to use the Radio Shack® TRS-80® 
Model 4 personal computer with the TKiSolver program. It in- 
cludes a list of the hardware required to run the program, the 
TKiSolver names and descriptions for the keys used by the pro- 
gram, and information about the Model 4 operating system 
(TRSDOS) as it is used with the TKiSolver program. 

In some instances, the directions for a single-drive system are dif- 
ferent from those for a multiple-drive system. Directions for 
multiple-drive systems are marked with a double line; those for 
single-drive systems are marked with a single line. 

If you have a hard disk, follow the directions that correspond to 
the number of disk drives you have with your hard disk. How- 
ever, the directions in this manual do not take full advantage of 
your hard disk. For detailed instructions on using the TRSDOS 
commands with a hard disk, see the TRS-80 Model 4 Hard Disk 
Start-Up Manual . 

What You Need 

To use the TKiSolver program, you need: 

• The Radio Shack TRS-80 Model 4 computer with at least 128K 
and one or more disk drives. Two disk drives are recom- 
mended. 

• The TKiSolver program diskette. The program diskette con- 
tains both TKiSolver program files and TRSDOS utilities and 
system files. 

• Extra 5-1/4-inch diskettes to store information. 
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Note: Before a blank diskette can be used to store information, 
it must be formatted. Formatting is a process that prepares the 
diskette to accept information. For instructions, see either the 
section in this chapter titled “Formatting a Diskette” or the 
TRS-80 Model 4 Disk System Owner's Manual. 


Optional items are: 

• A Radio Shack parallel printer. 

• One or more hard disks. 


Cursor 

The cursor is a rectangular block of light. Its size changes accord- 
ing to its position on the screen. 

Cue 

The cue is an underscore or block of light. It is one character wide 
and marks the current position in a line. 

Error Signal 

The error signal is a beep. 



Figure 2-1 


Notes About the Keyboard 

Figure 2-1 is a diagram of the Model 4 keyboard. The highlighted 
keys are the special keys used for the TKISolver program. The 
following descriptions specify how these keys work in the 
TKISolver program. They may function differently in TRSDOS 
and in other programs. 
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Arrows 


0 

0 

0 

0 


The Arrow keys move the cursor up, down, left, 
and right. They are represented in this text by the 
symbols t , I , * , and # . If information has just 
been typed, an Arrow key also enters the infor- 
mation in the current cursor position before mov- 
ing the cursor. If you are loading a file using the 
Storage command, * begins Directory Scrolling. 
Directory Scrolling is explained in Chapter 4. 


The Arrow keys work differently when you are 
using the TKISolver Editor. The Editor is ex- 
plained in Chapter 7. 


Backspa ce 

r 

F2 

V J 


Break 



Clear 

/- 

CLEAR 
V 


In the TKISolver program, the key labeled F2 is 
the Backspace key. It is located in the top row of 
keys in the numeric keypad. The Backspace key 
deletes the character to the left of the cue. It is 
represented in this text by the symbol ◄ . 

The Break key cancels whatever you type. It does 
not, however, cancel a command that has already 
been executed. This key is represented in the text 
by the symbol <8) . When you don’t know what else 
to do, <8) is a panic button that may help. 

The Clear key is located on the right side of the 
keyboard and is marked CLEAR. Hold down the 
Clear key to type a command or display special 
symbols on the screen. 

In the TKISolver program, use the Clear key to 
type the following special characters: 


To type: 

A (exponentiation 
symbol) 

\ (backslash) 


Hold down: and Press: 
Clear ; 

Clear / 


(underscore) 


Clear 


Enter 
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Edit 



Enter 

f "\ 

ENTER 
V ) 


Shift 

r 

SHIFT 


f >k 

CAPS 
v > 


The Edit key for the TK! Solver program is the 
key labeled F3. It is located in the top row of keys 
in the numeric keypad. The Edit key calls the 
TK! Solver Editor. This key is represented in the 
text by the symbol 0. The TK! Solver Editor is 
discussed in detail in Chapter 7. 

The Enter key enters information or completes a 
command. It is represented in the text by the sym- 
bol ♦ . 

There are two Shift keys, one on either side of the 
last row of alphabetic keys. As on a typewriter, if 
a Shift key is held down while a character is 
typed, the character is typed in uppercase. A Shift 
key is also used to type the special characters that 
appear on the top half of the number keys. 

To lock in uppercase letters, press the CAPS key 
on the right side of the space bar. To return the 
keyboard to both uppercase and lowercase let- 
ters, press the CAPS key again. 


Table 2-1 summarizes the symbols used in this text. 



Text 


Symbol 

Key 

(8) 

Break 

♦ 

Enter 

* 

Left arrow 

m 

Right arrow 

t 

Up arrow 

t 

Down arrow 

◄ 

Backspace (F2 key) 

0 

Edit (F3 key) 

A 

Exponentiation (Hold down CLEAR, press ;) 

\ 

Backslash (Hold down CLEAR, press /) 

Table 2-1 

Underscore (Hold down CLEAR, press ENTER) 
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Files, Drives, and Diskettes 

If you have been using your computer for a while and are familiar 
with it, you may want to skip to the section in this chapter called 
“File-Naming Conventions” and then go on to Chapter 3. 

Before proceeding, please note that this manual assumes you will 
load the TKISolver program from drive 0. If you load and run the 
program from a hard disk, drive 0 is assumed to be the hard disk. 

Files 

Information on a diskette or hard disk is stored in groups called 
files. Files are like the files in a filing cabinet, identified by the 
names written on the folders. Your computer stores information 
magnetically on a diskette or hard disk and identifies the individ- 
ual files by their filenames. 

Just like a file folder, files on a diskette or hard disk can contain 
anything. They can contain programs or parts of programs, 
TKISolver models, the text of a report to be printed on a printer, 
or lists of numbers generated by a program as output. 

Disk Drives 

If you have one disk drive on the system unit, it is called drive 0. 
If you have two drives, the bottom drive is drive 0 and the top 
drive is drive 1 . TRSDOS begins to search for a file in drive 0. If 
the file is not stored on a diskette in drive 0, TRSDOS will search 
each additional drive. It is strongly recommended that you load 
the TKISolver program from drive 0 and leave the program disk- 
ette in that drive. For more information about loading the pro- 
gram, see Chapter 3. 

The Hard Disk 

The hard disk is an optional storage device with a memory capac- 
ity represented in millions of bytes (megabytes). When you install 
the hard disk, you assign a drive number to it. .In this manual, if 
you load and run the TKISolver program from the hard disk, the 
hard disk is assumed to be drive 0. 

Diskettes 

Whenever a diskette is not in a drive, it should be kept in its pro- 
tective sleeve to shield it from the dust in the air and the natural 
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oil on your fingers. Always hold the diskette along one of the 
closed edges and be careful not to touch it directly on the oval 
cutout. Dust, moisture, and oil can damage the diskette and de- 
stroy the information on it, as can exposing the diskette to high 
temperatures. 

Anything with an electric motor produces an electromagnetic 
field. Exposure to any magnetic field can erase information on a 
diskette. Be careful not to store diskettes where they will be ex- 
posed to these fields, such as on top of your computer, against a 
power cord, or next to a telephone or electrical outlet. 

Inserting a Diskette 

To insert a diskette into a disk drive, open the drive latch by gen- 
tly pulling up on the bottom of the latch. Insert the diskette into 
the drive so that the oval cutout on the diskette enters the drive 
first and the label enters last and is on top. See Figure 2-2. 



Figure 2-2 Figure 2-3 



If you are using a diskette without a label, slide it in so that the 
oval cutout enters first and the square notch is on the left. Close 
the latch as shown in Figure 2-3. 
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Using Your Computer 

The Disk Operating System (TRSDOS) 

The Model 4 Disk Operating System, or TRSDOS, is the control 
program that gives the computer its ability to load and run other 
programs. A part of TRSDOS is stored on the TKiSolver pro- 
gram diskette. 

TRSDOS must be booted before any other program can be 
loaded or run. After TRSDOS has been booted, the system is 
ready to accept TRSDOS commands. However, if you have one 
or more disk drives and no hard disk, you must have the follow- 
ing TRSDOS System files on a diskette in drive 0 at all times: 

• SYSO/SYS through SYS4/SYS 

• SYS6/SYS 

• SYS7/SYS 

• SYS10/SYS through SYS13/SYS 

These System files and the TRSDOS utilities to format and back 
up diskettes are included on the TKiSolver program diskette. 

If you have a hard disk, the TRSDOS System files listed above 
can be stored on the hard disk. 

Booting TRSDOS 

Turn on the computer. The ON/OFF switch is located on the 
right, under the computer keyboard case. Insert the TKiSolver 
program diskette into drive 0. To boot the operating system from 
this diskette, press the RESET key, the recessed button on the 
right side of the keyboard. 

Note: In this manual, TRSDOS must be booted from drive 0. If 
you have stored TRSDOS on a hard disk, see the TRS-80 Model 4 
Hard Disk Start-Up Manual for information about how to load 
it. 

As TRSDOS loads, you will see some messages on your screen. 
Answer the messages as directed. Consult the TRS-80 Model 4 
Disk System Owner's Manual for details. 
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You should see the TRSDOS system prompt: 

T R S DOS Ready 

The system prompt tells you that TRSDOS is ready to accept 
commands. 

TRSDOS Programs 
TRSDOS Commands 

The following four sections show you how to use four TRSDOS 
programs that are included on the TK! Solver program diskette. 
These programs, format, backup, dir, and copy, are ones you 
will need when you begin to use the TK! Solver program to create 
and save your own models. If you want to try the instructions 
given below, you will need two blank diskettes for your examples. 

Note: The directions below assume that you will use the 
TRSDOS programs included on the TKISolver diskette. For in- 
formation on using these programs from a hard disk, refer to the 
TRS-80 Model 4 Hard Disk Owner's Manual. 

Note: When following the directions below, make sure that you 
type the commands exactly as shown. TRSDOS will not accept 
additional spaces in some command lines. 


Formatting a Diskette 

Computers find information on a diskette by looking for elec- 
tronic markings that identify the information. Before a diskette 
can be used to save information, the diskette must be given these 
markings by the system. This process is called formatting the 
diskette. 

Formatting a diskette erases any information that is on it. You 
can recycle old diskettes by reformatting them and preparing 
them to accept new information. Do not reformat your 
TKISolver program diskette. If you do, you will erase the pro- 
grams on it. 
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You cannot format a diskette while running the TKISolver pro- 
gram. If you want to save the models you are creating, you must 
decide how many diskettes you want to have available for storing 
information and format them before you load the TKISolver 
program. 


Multiple-Drive Systems 

If you have not booted TRSDOS from the TKISolver program 
diskette, do so. Insert a blank diskette into drive 1 and type: 

FORMAT : 1 ♦ 

The system responds with a series of prompts that are displayed 
one at a time. Respond to each prompt by pressing ♦ . The 
prompts are: 

Diskette name ? 

Master password ? 

Single or Double density < S , D > ? 

Number of cylinders ? 

By pressing ♦ after each of these prompts, you tell the system to 
use a default. For a list of these defaults, see the TRS-80 Model 4 
Disk System Owner's Manual. The system now responds: 

Formatting cylinder 01 (02, 03, ...39) 

The next message is: 

Verifying cylinder 01 (02, 03, ...39) 

When the system has checked each cylinder on the diskette, it dis- 
plays the messages: 

Directory will be placed on cylinder 20 

Initializing SYSTEM information 

Formatting complete 
TRSDOS Ready 
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When you see the system prompt, remove the formatted, blank 
diskette from drive 1. Repeat this entire procedure to format a 
second blank diskette. When you have formatted both diskettes, 
label one “TKISolver Backup” and the other “Instruction Disk- 
ette ” You will use these two formatted diskettes later in this chap- 
ter. □ 


Single-Drive System 

If you have not booted TRSDOS from the TKISolver diskette, do 
so. After the system prompt, type: 

FORMAT :04 

The system responds with a series of prompts which are displayed 
one at a time. Respond to each prompt by pressing ♦ . The 
prompts are: 

Diskette name ? 

Master password ? 

Single or Double density <S,D> ? 

Number of cylinders ? 

By pressing ♦ after each prompt, you tell the system to use a de- 
fault. For a list of these defaults, see the TRS-80 Model 4 Disk 
System Owner's Manual. You should now see the message: 

Load destination diskette <ENTER> 

When the disk drive light has gone out, remove the TKISolver 
diskette from drive 0. Insert a blank diskette into the drive, mak- 
ing sure the oval cutout enters the drive first. Close the latch. 
Press ♦ . 

The system responds: 

Formatting cylinder 01 (02, 03, ...39) 

The next message is: 

Verifying cylinder 01 (02,03, ...39) 
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When the system has checked each cylinder on the diskette, it dis- 
plays the messages: 

Directory will be placed on cylinder 20 

Initializing SYSTEM information 

Load SYSTEM diskette < E N T E R > 

Remove the blank, formatted diskette and replace it with the 
TKISolver diskette. Press ♦ . The message is: 

Formatting complete 

Repeat this entire procedure to format a second blank diskette. 
When you have formatted both diskettes, label one “TKISolver 
Backup” and the other “Instruction Diskette.” You will use these 
two formatted diskettes later in this chapter. □ 

Backing up a Diskette 

It is a good idea to make copies of the diskettes on which you have 
stored your models. If an accident destroys the information on a 
diskette, the models that were on that diskette will be available on 
the backup diskette. 

For this example, you will make a single backup copy of the 
TKISolver program by copying the program diskette onto the 
blank diskette you formatted earlier. The TKISolver diskette is 
the SOURCE diskette and the formatted diskette labeled 
“TKISolver Backup” is the DESTINATION diskette. 

Note: If you want to run the TKISolver program from a hard 
disk, you must copy the entire TKISolver program diskette onto 
the hard disk. This procedure is discussed in Chapter 3. 


Multiple-Drive Systems 

If you have not booted TRSDOS, do so. Insert the diskette la- 
beled “TKISolver Backup” into drive 1. Type: 


BACKUP : 0 : 1 (X) ♦ 
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You should see the message: 

Insert SOURCE disk < E N T E R > 

Make sure the TKISolver diskette is in drive 0, then press ♦ . You 
should see the message: 

Destination disk ID is different: 

Name = DATADISK D a t e = date 
Are you sure you want to backup to it 
< Y , N > ? 

This message is telling you that the destination diskette name 
datadisk is different from the name given to the TKISolver disk- 
ette. Even though the names are different, you can still back up 
the TKISolver diskette onto the datadisk. Answer this prompt 
by typing: 

Y ♦ 

The system responds: 

Loading cylinder 01 (02, 03, ...) 

This is replaced by the messages: 

Dumping cylinder 01 (02, 03, ...) 

Verifying cylinder 01 (02, 03, ...) 

When the backup procedure is complete, the system displays the 
message: 

Source disk is write protected; MOD flags 
not updated 

Insert SYSTEM disk < E N T E R > 

Press ♦. TRSDOS responds: 

Backup comp l et e 

The diskette in drive 1 should now contain a backup copy of the 
TKISolver program diskette, n 
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Single-Drive System 

If you have not booted TRSDOS, do so. Type: 

BACKUP : 0 : 0 (X) ♦ 

The system reponds: 

Insert SOURCE diskette < E N T E R > 

Make sure the TKISolver program diskette is in the drive, then 
press ♦ . The next message is: 

Insert DESTINATION disk < E N T E R > 

Remove the TKISolver diskette from drive 0 and replace it with 
the formatted diskette labeled “TKISolver Backup.” Press ♦. 
You should now see the message: 

Destination disk ID is different: 

Name = DATADISK Date = date 
Are you sure you want to backup to it 
< Y , N > ? 

This message is telling you that the destination diskette name 
data disk is different from the name given to the TKISolver disk- 
ette. Even though the names are different, you can still back up 
the TKISolver diskette on the datadisk. Answer this prompt by 
typing: 

Y ♦ 

You should now see the message: 

Insert SOURCE disk < E N T E R > 

Remove the destination diskette and replace it with the 
TKISolver diskette. Press + . The system reads the diskette and 
then displays the message: 

Loading cylinder 01 (02, 03, ...10) 

Insert DESTINATION disk < E N T E R > 

Remove the TKISolver diskette and replace it with the destina- 
tion disk. The message is: 
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Dumping cylinder 01 (02, 03, ...10) 

This is replaced by the messages: 

Verifying cylinder 01 (02, 03, 04, 05. ..10) 

Insert SOURCE diskette < E N T E R > 

Each time you are prompted for the SOURCE diskette, insert the 
TKISolver program diskette into drive 0 and press ♦. When you 
are prompted for the DESTINATION disk, insert the backup 
diskette into drive 0 and press ♦. 

When you have finished backing up the TKISolver diskette, you 
should see the message: 

Source disk is write protected; MOD flags 
not updated 

Insert SYSTEM disk < E N T E R > 

Press ♦. TRSDOS responds: 

Bac kup comp l et e 

Your destination diskette now contains a backup copy of the 
TKISolver program diskette, j 

Creating Storage Diskettes 

If you have only one disk drive and no hard disk, you must create 
storage diskettes by first making a backup of the TKISolver disk- 
ette and then removing files which are unnecessary for operating 
the TKISolver program. 

To create storage diskettes for use on a single-drive system, con- 
tinue this procedure which allows you to remove files unneces- 
sary for operating the TKISolver program. 

Be sure a backup of the TKISolver diskette is in the drive, then 
type the two commands below, pausing a moment between them 
while the files are removed: 

PURGE BACKUP/CMD:0 (Q=N,I)4 
PURGE FORMAT / CMD:0 (Q=N,I)4 
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This deletes the two TRSDOS programs backup and format, al- 
lowing more space for model storage. 

Instruction Files, available on the TKISolver program diskette 
for use with the Instruction portion of this manual, may be dele- 
ted from your storage diskette by typing: 

PURGE / T K : 0 ( Q = N ) ♦ 

If you load the TKISolver program from a complete backup of 
the TKISolver program diskette, the tk/cmd file will not be re- 
quired for normal operation from a storage diskette. To release 
more diskette space for model storage, you may remove the 
TK/CMD file by typing: 

PURGE TK/CMD : 0 (Q = N) ♦ 


As an option even more storage space may be made available by 
deleting the TKISolver Help File. The TKISolver Help File pro- 
vides immediate descriptions and explanations to assist you in 
employing the TKISolver program as an effective computational 
tool. For this reason, removal of the Help File is not recom- 
mended to the novice user. To delete the Help File, type: 

PURGE T K / H LP : 0 <Q = N) ♦ 


Removal of these files from a backup copy of the TKISolver disk- 
ette should provide sufficient model storage space to single-disk- 
drive users without jeopardizing the normal operation of the 
TKISolver program. It is important to remember that deletion of 
these files eliminates the capabilities which these files provide. 
Removal of the tk/cmd file will prevent you from loading the 
TKISolver program from your storage diskette. If you remove 
tk/cmd from your storage diskette, be sure to load the 
TKISolver program from a complete program diskette, then re- 
place this diskette with the diskette upon which your model is 
stored. 


Listing the Contents of a Diskette 

To find out which files are on a diskette, use the TRSDOS pro- 
gram dir to list the contents of the diskette. For example, replace 
any diskette you may have in drive 0 with the backup copy of the 
TKISolver program diskette you just created. Type: 
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DIR ♦ 

The contents of the “TKISolver Backup” diskette should be dis- 
played on your screen. 

Note: If you have diskettes inserted in any other active drives, 
the dir command will also display the contents of those diskettes. 
Otherwise, the system displays the message [NO DISK] next to 
the drive number. 

To list the TRSDOS System files that are on a diskette, add the 
SYS parameter to the command. For example, with the TKISolver 
backup diskette still in the drive, type: 

DIR (SYS) ♦ 

You should see the TRSDOS System files that are contained on 
the diskette as well as the other TK! Solver files. 

Specifying a Drive 

If you have multiple drives on your computer, you may want to 
list the contents of a diskette that is not in drive 0. 

To designate a specific drive when using a TRSDOS command, 
type the command, a colon (:), and then the number identifying 
the drive. When you use this syntax, the program goes to the 
specified drive and performs the command. 

The syntax is: 

command : drive number ♦ 

For example, insert the TRSDOS diskette into drive 0 and the 
backup copy of the TKISolver program diskette into drive 1. 
Type: 

DIR : 1 ♦ 

You should see only the contents of the “TKISolver Backup” 
diskette on your screen. 
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Copying a File 

You may need to copy an individual file from one diskette to an- 
other to use as a backup copy or somewhere else. You can copy a 
file from one diskette to another formatted diskette. You can also 
copy a file from a hard disk to a formatted diskette or from a 
diskette to a hard disk. 

If you plan to copy the TKISolver program onto a hard disk, you 
do not need to copy the tk/OVL and tk/hlp files onto storage 
diskettes. The TKISolver program uses these files directly from 
the hard disk. 


Multiple-Drive Systems 

If you have not already booted TRSDOS, do so. Insert the disk- 
ette labeled “Instruction Diskette” into drive 1. 

Make sure the source diskette is in drive 0, then type the following 
command: 

COPY <filename>:0 : 1 ♦ 

where < filename > is the name of the file you want to copy. 
The system responds: 

Copying: <filename>:0 to <fiLename>:1 

When the copy procedure is finished, you should see the system 
prompt on the screen. □ 


Single-Drive System 

If you have not already booted TRSDOS, do so. Make sure the 
source diskette is in drive 0, then type the following command: 

COPY <fi tename> : 0 : 0 ( X ) ♦ 

The system responds: 

Insert SOURCE disk < E N T E R > 
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You will be asked several times to insert the SOURCE disk, the 
SYSTEM disk, and the DESTINATION disk. When you are 
prompted for either the SOURCE or SYSTEM disk, insert the 
source diskette into drive 0 and press ♦ . When you are prompted 
for DESTINATION diskette, insert the formatted diskette you 
labeled “Instruction Diskette” and press ♦ . 

You should finish the copy procedure with the TK! Solver diskette 
in the drive. □ 

File-Naming Conventions 

When you use the TKISolver Storage command to save a file, you 
will be asked to give the file a name. TRSDOS imposes certain 
limitations on how files are named. These limitations are: 

• Filenames must be one to eight characters long. 

• Filenames must begin with a letter. 

• Filenames may contain any uppercase lowercase letter and any 
number from 0 through 9. 

• Filenames cannot contain any other characters. 

Filenames also have extensions that identify the type of file you 
are naming. Extensions are one to three characters preceeded by a 
slash (/). The first character of an extension must be a letter. 

If you save a file using the TKISolver program, the program au- 
tomatically attaches the correct extension. If you are naming files 
to save and load using the TKISolver Storage command, you do 
not have to include the extension as part of the filename, al- 
though you may. The TKISolver program looks for the appropri- 
ate extension. 

The TKISolver extensions are: 

/TK for TKISolver models and parts of models 
/DIF for files in DIF format 

/PRF for print files, files which contain images for the 
printer 
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Note: If you create a print file using the TK! Solver program 
and want to see what is in the file, go to TRSDOS and use the list 
command. Seethe TRS-80 Model 4 Disk System Owner's Manual 
for information about using this command. 


Conclusion 

This chapter has described some features of your computer and 
TRSDOS. The next chapter discusses how to load and run the 
TKISolver program, how to use the diskettes while reading the 
Instruction Manual, and how to quit the program. 
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Chapter 3 Loading the TKISolver Program 

• The TKISolver diskette 

• The TKISolver files 

• Creating the Instruction diskette 

• Loading the TKISolver program 

• The TKISolver program and the hard disk 

• The Quit command (/Q) 

The TKISolver program diskette contains several files, some of 
which are program files and some of which are for use with this 
manual. This chapter tells you about the TKISolver program 
diskette and the files on it. It also gives you instructions for creat- 
ing the Instruction diskette you will use with this manual and for 
putting the TKISolver program on a hard disk. You will also learn 
how to load and quit the TKISolver program from both a diskette 
and a hard disk. 

If your computer has two or more drives, follow the directions 
under the heading “Multiple-Drive Systems” If your computer 
has one disk drive, follow the directions under the heading 
“Single-Drive Systems.” If the number of drives is not specified, 
the text applies to both single- and multiple-drive systems. If your 
computer has a hard disk, follow the directions under the head- 
ing “The TKISolver Program and the Hard Disk.” 

The TKISolver Diskette 

You may make six backup copies of the TKISolver program disk- 
ette and one backup copy on a hard disk for use on a single com- 
puter. Any other copying of the TKISolver program diskette or 
the TKISolver program files is unauthorized and is a violation of 
copyright law and the TKISolver license agreement. 

The TKISolver Files 

The Overlay File, tk/ovl, contains a part of the TKISolver pro- 
gram, and the Help File, tk/hlp, contains the text for the Help 
Facility. Because these two files are not read into memory when 
the program is loaded, they must be available to the program 
when it is being used. 
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If you have these files on a storage diskette, you will be able to use 
the storage diskette in place of the program diskette after you 
have loaded the program. 


Note: If you plan to load and run the TKISolver program from 
a hard disk, you do not have to copy TK/OVL and tk/hlp onto 
any storage diskettes. These files are available to the program 
from the hard disk. However, this manual assumes that if you 
copy the TKISolver program to a hard disk, TRSDOS is also on 
the hard disk. 


Single-Drive Systems 

If you have one drive on your system and no hard disk, you must 
have the file tk/ovl on every storage diskette. If you want to use 
the TKISolver Help Facility, you also need to have tk/hlp. Each 
storage diskette must also contain the following TRSDOS System 
files: 

• SYSO/SYS through SYS4/SYS 

• SYS6/SYS 

• SYS7/SYS 

• SYS10/SYS through SYS13/SYS 

The easiest way to create extra storage diskettes is to back up the 
Instruction diskette that you will make in the next section. The 
Instruction diskette will contain tk/ovl, tk/hlp, the Instruction 
Files, and the TRSDOS System files listed above. You can then 
remove the Instruction Files from the storage diskettes, using the 
TRSDOS purge command. To create storage diskettes on a 
single-drive system, see the section titled “Creating Storage Disk- 
ettes.” □ 

Note: For the rest of this manual, you need only the storage 
diskette labeled “Instruction Diskette” that you formatted and 
used in Chapter 2. 
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Multiple-Drive Systems 

If you keep your backup copy of the TK! Solver program diskette 
in drive 0, you can use storage diskettes without the files TK/OVL 
and tk/hlp in the other drives; you do not have to copy these 
files onto any storage diskettes if you prefer not to. □ 

Note: For the rest of this manual, you need only the storage 
diskette labeled “Instruction Diskette” that you formatted and 
used in Chapter 2. 


Using the TKfSolver Files 

Load the TKISolver program from a backup copy of the program 
diskette according to the instructions given below. You will be 
able to continue using the program as long as tk/ovl and the 
TRSDOS System files are available on a diskette in drive 0 or are 
on a hard disk. 

If you quit the program and return to TRSDOS, you must load 
the TKISolver program again. If you turn off the computer, you 
must boot TRSDOS and then load the program. 

Creating the Instruction Diskette 

This section shows you how to create the Instruction diskette you 
will need for this manual. After you load the program, you will 
replace the program diskette with the Instruction diskette and 
continue with the manual. 

Note: If you plan to copy the TKISolver program onto a hard 
disk, you do not need to create the Instruction diskette. Copies of 
the Instruction Files will be stored on the hard disk. 

The Instruction diskette is the storage diskette you will use while 
working through this manual. It will contain the files tk/ovl and 
TK/HLP and the eight Instruction Files that you will use while you 
are learning the program. It will also contain some TRSDOS Sys- 
tem files. 
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To make the Instruction diskette, you will back up the entire 
TKiSolver program diskette and then remove the TRSDOS pro- 
grams backup/CMD and FORMAT/CMD and the TKiSolver pro- 
gram file TK/CMD from it. When you have finished creating your 
Instruction diskette, we recommend that you make a backup 
copy of the Instruction diskette before beginning Chapter 4. 


Multiple-Drive Systems 

If you have not booted TRSDOS from the TKiSolver program 
diskette, do so. In drive 1 , insert the diskette you created in Chap- 
ter 2, labeled “Instruction Diskette.” Type: 

BACKUP : 0 : 1 (X) ♦ 

The system responds: 

Insert SOURCE diskette < E N T E R > 

Press ♦ . The entire TKiSolver diskette should now be copied to 
the Instruction diskette. When the backup procedure is finished, 
you are ready to remove the TRSDOS programs backup/cmd 
and FORMAT/CMD and the TKiSolver program file TK/CMD from 
the Instruction diskette. By removing these files, you increase the 
storage space on the Instruction diskette. 

Type the three commands below, pausing between each one as the 
files are removed: 

PURGE BACKUP/CMD:1 (Q=N,I)4 
PURGE FORMAT / CMD : 1 ( Q = N # I ) ♦ 

PURGE TK/CMD : 1 <Q = N) ♦ 

When the system prompt is displayed after removing TK/CMD, 
your Instruction diskette is ready to use. 

Use the dir command with the SYS parameter to list the contents 
of the diskette in drive 1. You should see the eight Instruction 
Files, the files tk/ovl and tk/hlp, and eleven TRSDOS System 
files. □ 


Chapter 3 

Loading the TKJSolver Program 


Single-Drive Systems 

If you have not booted TRSDOS, do so. Type: 

BACKUP : 0 : 0 (X) ♦ 

The system responds: 

Insert SOURCE diskette < E N T E R > 

Make sure the TKISolver program diskette is in drive 0, then 
press ♦. The system now copies some of the files into memory 
and then prompts: 

Insert DESTINATION diskette < E N T E R > 

Remove the TKISolver diskette and replace it with the diskette 
labeled “Instruction Diskette” that you created in Chapter 2. 
Press ♦. 

Keep switching diskettes until all the files are copied. You will 
have to switch the diskettes many times before the copy is com- 
pleted. 

When the last file is copied, the TKISolver diskette should be in 
the drive. You are now ready to remove the TRSDOS commands 
BACKUP/CMD and FORMAT/CMD and the TKISolver program file 
TK/CMD from the Instruction diskette. By removing these files, 
you increase the amount of storage space on the Instruction disk- 
ette. 

Remove the TKISolver diskette from the drive and replace it with 
the Instruction diskette. Type the following three commands, 
pausing between each one as the files are removed: 

PURGE BACKUP/CMD:0 (Q=N,I)4 
PURGE F0RMAT/CMD:0 (Q=N,I)4 
PURGE TK/CMD : 0 ( Q = N ) ♦ 

When the system prompt is displayed after removing TK/CMD, 
your Instruction diskette is ready to use. 
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Use the dir command with the SYS parameter to list the contents 
of the Instruction diskette. You should see the eight Instruction 
Files, the files tk/ovl and tk/hlp, and eleven TRSDOS System 
files. □ 

Creating Storage Diskettes 

If you are using a single-drive system, the easiest way to create 
storage diskettes is to back up the Instruction diskette you just 
created and remove the Instruction Files. This will give you more 
room on the storage diskette for your own model files. 

To create a storage diskette, first format a blank diskette. This 
will be the DESTINATION diskette. Then, insert the Instruction 
diskette in the drive. This will be the SOURCE diskette. Type: 

BACKUP : 0 :0 (X) ♦ 

Follow the messages as before, inserting the SOURCE disk and 
DESTINATION disk when prompted. When you have com- 
pleted the backup, you are ready to remove the Instruction Files 
from the storage diskette. 

Insert the storage diskette into the drive and type: 

PURGE /TK : 0 ( Q = N ) ♦ 

When TRSDOS has purged all the Instruction Files from your 
storage disk, it is ready to use. If you want, you can then back up 
this disk to make additional storage diskettes. 

Loading the TKiSolver Program 

This section explains how to load the TKiSolver program. Use 
the backup copy of the program diskette, which you created in 
Chapter 2, to load the program. This saves wear on your original 
program diskette. Directions for saving the TKiSolver program 
on a hard disk and loading it from the hard disk are given later in 
this chapter. 

The instructions in this manual assume that you will load and use 
the TKiSolver program diskette and Instruction diskette from 
drive 0. If you use only drive 0, you do not have to designate a 
particular drive while you are learning to use the program. 
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If you have not already booted TRSDOS from the TKiSolver 
diskette, do so. After the TRSDOS system prompt, type: 

TK ♦ 

The screen should look like Figure 3-1. 


Version 01.00.00 
of the TKiSolver (R) Program 


This program is a product of 
SOFTWARE ARTS, INC. 

Copyright (c) 1984 Software Arts, Inc. 

All Rights Reserved. 

Licensed for Distribution to Tandy Corporation 

Except as specifically authorized, 
copying of any part of this program 
is prohibited. 


***** Press ENTER to Start ***** 


Figure 3-1 


Note: The version number may be different for your program. 


This screen shows the TKiSolver copyright notice, the program 
version number, and the message: 

Press ENTER to Start 
Press ♦. 

While the program loads, the message is: 

Loading the TKiSolver program 
Copyright (c) 1984 Software Arts, Inc. 
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When the program is loaded, the screen should look like Figure 
3-2. The TKISolver program is now ready to be used. 


( 1 r ) Rule: 

For Help, type ? 


St Input Name 


S Rule 


VARIABLE SHEET ============ 

Output Unit Comment 


RULE SHEET 


Figure 3-2 

Note: If you try to load the program and you get the message: 

A NON-RECOVERABLE PROGRAM ERROR 
has occurred. Please write down 
the information listed below and 
refer to the Reference Manual 
for further instructions. 

you have probably set up a MEMDISK in Bank 0 (zero) of mem- 
ory before you loaded the program. To load the TKISolver pro- 
gram successfully, you must disable MEMDISK. 

If you need to stop working while you are using the manual, use 
the Save option of the Storage command, explained in the next 
chapter, to save your work in a file on the Instruction diskette 
before you quit the program. 
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When you are ready to continue with the manual, boot TRSDOS 
and load the TKiSolver program again. Then use the Load File 
option of the Storage command, explained in the next chapter, to 
load the file you were working with and continue with the man- 
ual. 

The TKiSolver Program and the Hard Disk 

If you plan to load and run the TKiSolver program from a hard 
disk, the instructions in this manual assume that you have in- 
stalled your hard disk and that the system recognizes the hard 
disk as drive 0. If you use only the hard disk, you do not need to 
designate a particular drive while you are learning to use the pro- 
gram. All files you save while using this manual should be saved 
on the hard disk. 

Copying the TKiSolver Program onto the Hard Disk 

To copy the TKiSolver program onto the hard disk, insert the 
BOOT diskette (a backup of the Hard Disk Installation diskette) 
into drive 0. Follow the instructions in the TRS-80 Model 4 Hard 
Disk Start-Up Manual to boot TRSDOS from the hard disk. 

When you see the TRSDOS Ready prompt, remove the TRSDOS 
BOOT diskette from the bottom disk drive and replace it with the 
TKiSolver diskette. Type: 

BACKUP : diskette drive number :hard disk number (NEW) ♦ 

The diskette drive number is the number of the bottom disk drive 
which contains the TKiSolver diskette. The hard disk number is 
the drive number of the hard disk where you want the program to 
be stored. 

Note: When you install the hard disk and store TRSDOS on it, 
the hard disk becomes drive 0 and the bottom disk drive is renum- 
bered. The number of the bottom disk drive is determined by the 
number of logical drives you assign to the system during hard- 
disk installation. 


TKiSolver Instruction Manual 


All the files on the TKiSolver program diskette should now be 
copied from the TKiSolver diskette to the hard disk. When the 
backup procedure is complete, you should see the TRSDOS sys- 
tem prompt. Remove the TKiSolver diskette and keep it as a 
backup copy. You are now ready to load the TKiSolver program 
from the hard disk. 

Loading the TKiSolver Program from Hard Disk 

If you have not already done so, boot TRSDOS from the hard 
disk. When you see the system prompt, type: 

TK 0 

The screen should now look like Figure 3-1 . This screen shows the 
TKiSolver copyright notice, the program version number, and 
the message: 

Press ENTER to Start 
Press ♦ . 

While the program loads, the message is: 

Loading the TKiSolver program 
Copyright (c) 1984 Software Arts, Inc. 

When the program is loaded, the screen should look like Figure 
3-2. The TKiSolver program is now ready to be used. 

Note: If you try to load the program and you get the message: 

A NON-RECOVERABLE PROGRAM ERROR 
has occurred. Please write down 
the information listed below and 
refer to the Reference Manual 
for further instructions. 

you have probably set up a MEMDISK in Bank 0 (zero) of mem- 
ory before you loaded the program. To successfully load the pro- 
gram, you must disable MEMDISK. 
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If you need to stop working while you are using the manual, use 
the Save option of the Storage command, explained in the next 
chapter, to save your work in a file on the hard disk or on a disk- 
ette before you quit the program. As long as you have booted 
TRSDOS from the hard disk, all files you save will automatically 
be stored on the hard disk. 

When you are ready to continue with the manual, boot TRSDOS 
from the hard disk and load the TKISolver program again. Use 
the Load File option of the Storage command, explained in the 
next chapter, to load the file you were working with, and continue 
with the manual. 




The Quit Command (/ Q) 

Quitting the TK! Solver program stops the program, clears the 
computer’s memory, and returns you to TRSDOS system level. 
The Quit command begins with a slash (/). 

Type: 

/ 

The Prompt/Error line at the top of the screen shows the list of 
commands that begin with a slash. The options are: 


B 

Blank 

p 

Print 

C 

Copy 

Q 

Quit 

D 

Delete 

R 

Reset 

E 

Edit Field 

S 

Storage 

I 

Insert 

w 

Window 

L 

List 

! 

Solve 

M 

Move 




The command Q, for Quit, is the first command discussed in this 
manual. The others will be discussed as they arise. Type: 


Q 

The prompt is: 
Quit: Y N 
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Because the Quit command stops the program and clears the 
computer’s memory, it requires a confirmation so that you do not 
quit the program accidentally and lose your work. Typing Y 
clears the TKISolver program from the screen. Typing N cancels 
the Quit command. 

Type: 

Y 

The TKISolver program is cleared. 

Note: If you want to quit the program and you do not need to 
return to TRSDOS, simply remove any diskettes that are in the 
drives and turn off the computer. 


To continue, load the TKISolver program from TRSDOS by typ- 
ing: 

TK $ ♦ 

When the program has been loaded and your screen looks like 
Figure 3-2, remove the program diskette from drive 0 and replace 
it with the Instruction diskette. If you loaded the program from 
the hard disk, you do not need any diskette in the drive. You are 
now ready to begin Part II. 

Conclusion 

This chapter has told you about the TKISolver program diskette 
and files, shown you how to create your Instruction diskette, and 
given you instructions for loading and quitting the TKISolver 
program from both the diskette and the hard disk. In the next 
chapter you will begin to use the TKISolver program. 



Part II 


Building and Using a Model 


Part II Building and Using a Model 

In Part II of the Instruction Manual you will begin to work with 
models. A model is a representation of a theoretical situation 
within a given environment. TKISolver models are mathematical 
models that use sets of equations to define the relationships be- 
tween variables. 

Part II shows you how to build, use, and refine a TKISolver 
model. It starts with the preliminary commands you need to 
move around in the program, and then guides you while you 
build a model named travel, travel begins as a simple model 
and is used throughout the rest of the Instruction Manual. As you 
use it, you will see how a model can be built, used, changed, de- 
veloped, revised, and expanded to express a variety of problems 
and how to find solutions to these problems. Part II gives you all 
the basic commands and features you need to begin using the 
TKISolver program. 


Contents of Part II: 

• Chapter 4 Starting Up 

• Chapter 5 Moving Around 

• Chapter 6 Building a Model 

• Chapter 7 Solving a Model 

• Chapter 8 Units 

• Chapter 9 Global Setting and Printing 
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Chapter 4 Starting Up 

• The TK! Solver sheets 

• The TK! Solver screen 

• The Help Facility 

• The Storage command (/S) — Load File (L), Save Model (S), 
and Delete File (D) options 

• Directory Scroll feature 

Before you begin to build and solve models using the TK!Solver 
program, you should know how to save and load files so that you 
can begin and end your sessions with the program when you wish. 

Chapter 3 showed you how to load and quit the program. This 
chapter describes what you see on your screen, and shows you 
how to use the Help Facility, and how to load, save, and delete a 
file. 


To begin this chapter: 

If you did not quit the program at the end of the last chapter, you 
are ready to begin Chapter 4. 

If you quit the program at the end of Chapter 3, load the 
TK! Solver program according to the instructions given in Chap- 
ter 3. 


The screen should look like Figure 4-1. 
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(1r) Rule: 

For Help, type ? 

==================== VARIABLE SHEET ============ 

St Input Name Output Unit Comment 


==================== rule SHEET 

S Rule 


Figure 4-1 

The TKISolver Sheets 

If you were writing a model without the TK! Solver program, you 
would probably begin by writing down your equations on a sheet 
of paper and then painstakingly solve them using a calculator. 
The TKISolver program provides you with screen displays called 
Sheets which you use like sheets of paper to record not only your 
equations, but the properties or characteristics of each variable 
including values and units, conversion definitions for units of 
measure, and a variety of other features. 

Each sheet is made up of columns and rows or labeled lines or a 
combination. The two sheets that are currently on your screen are 
the Variable Sheet, at the top, and the Rule Sheet, at the bottom. 
Both are composed of columns and rows. 

The information that you put on the sheets goes into spaces called 
fields. The cursor is the screen marker that moves from field to 
field to show you where you are on the sheet. 

You use the TKISolver commands to move around and between 
the sheets, to enter items of information into the fields, creating a 
model, and to solve your models. 


TKISolver Instruction Manual 


The TKISolver Screen 
The Message Area 

At the top of the screen are two lines called the Message Area. 
The first line, the Status line, displays the program status. The 
second line, the Prompt/Error line, displays messages. 

The Status Line 

At the far left of the Status line, in parentheses, are a letter and 
number that tell you the field position of your cursor. It currently 
says lr. This is the Position Indicator. The number is the row 
number of the field currently containing the cursor (in the exam- 
ple, the first row on the Rule Sheet); the letter represents the col- 
umn label (Rule). 


( 1 r ) Rule: 
For Help, 

type ? 


St Input 

Name 

= V A R I / 

Out pi 


Status Line 
Prompt/Error Line 


To the right of the Position Indicator is a space for the label and 
contents of the current field. Since you have not entered any in- 
formation yet, the screen shows only the label Rule followed by a 
colon (:). If there were an item in the field, the item would appear 
on the Status line following the label. If the item is larger than the 
field, you can usually see the entire item by moving the cursor to 
the field and looking at the Status line. 

Note: Values are shown on the Status line rounded to the pro- 
gram’s full accuracy of 12 significant digits. 
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On the far right side of the Status line is a number called the 
Memory Indicator. The Memory Indicator tells you how many K 
(1024) bytes of memory you have left. This number depends on 
the memory capacity of your computer and may not match the 
number shown in the Figure. 

| Memory Indicator 

1 29/ 1 # — Solution Indicator 

BLE SHEET ================ 

t Unit Comment 


If the amount of memory goes below 1 K bytes, the Memory Indi- 
cator shows LOW. If this happens, you still have memory left and 
can save your model. As a precaution, you should save your 
model when you see this message. 

When you have run out of memory, the Memory Indicator shows 
the message OUT. There is still usually enough memory left for 
you to save your model, and you can delete parts of your model 
to create space in memory, but if you try to add to the model or 
solve it after the OUT message appears, it may not work. 

The Memory Indicator is followed by a slash to separate it from 
the Solution Indicator. There is no Solution Indicator on your 
screen yet. When you enter your first equation, an exclamation 
point ( ! ) will appear after the slash to show that your current 
model is unsolved. The Solution Indicator appears after any 
modification to the model that will affect the solution. It remains 
displayed until the model is solved without errors. 

The Prompt/Error Line 

Below the Status line is the Prompt/Error line. The program uses 
this line to prompt for a typed response and to display program 
status messages and error messages. You will see many status 
messages and prompts as you work through this manual. 
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The Help Facility 

When the program is loaded, the first message to appear on the 
Prompt/Error line is the Help message: 

For Help, type ? 

The Help Facility reminds you of features and commands you 
have learned but may not remember. It is not intended as a substi- 
tute for the Instruction or Reference Manuals. 

The Help message is just a reminder about how to call the Help 
Facility and disappears when you type any key. It does not have to 
be displayed to use the Help Facility. 

If you need help, type a question mark (?). 

Type: 

? 

The message that appears on the Prompt/Error line is the Help 
prompt: 

Help: ? or topic: 

The marker that you see on the Prompt/Error line is the cue. It 
marks your position on the line and is there to indicate that you 
must type a response. The options are: 

Option: Shows: 

? Instructions for using the Help Facility. 

TOPICS ♦ A list of available topics. 

Any topic ♦ Information on that topic. If you enter anything 
other than a topic or ?, the program tries to find 
it among the topics. 

♦ The previous TKiSolver sheet. 
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Display the instructions for using Help. Type: 


The screen shows instructions for using the Help Facility. After a 
time, there is a message at the top of the screen: 

Next page: Y N 

This tells you that there is more than one page of information 
about ? in the file. 

Look at the next page by typing Y. 

This screen shows more information about ?, but it is not about 
the Help Facility. The Help Facility gives you all the information 
it has about the topic, even if it is more than you want to know. 

The Help prompt appears again at the top of the screen. When 
the Help prompt appears, it means that the current page of Help 
text is the last or only page of text on the topic, and you can ask 
for a new topic, or leave the Help Facility. 

Now look at the list of Help topics by responding to the Help 
prompt with: 

TOPICS ♦ 

This is a list of some of the topics covered in the Help File. This 
time, in response to the message at the top of the screen, type: 

N 

The Help prompt appears again. 

To get information about a particular topic, type and enter it. For 
example, type: 

QUIT 

Press ♦ to enter the topic. While the program is finding the 
topic, it displays the message: 

Searching the Help file 
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The search may take a few minutes. When the program has com- 
pleted the search, it displays a page of text describing how to quit 
the program. 

If the topic you have requested does not exist, a message on the 
Prompt/Error line tells you that it is not a topic and asks you if 
you want more help. Typing Y returns the Help prompt and typ- 
ing N returns you to the previous sheet. 

Return to the previous TKiSolver sheet by typing: 

♦ 

The screen should again look like Figure 4-1 , except that there is 
no Help message. 

Using a Storage Diskette— The Storage Command 

The Storage command saves and loads files. If you want to keep 
your model, be sure to save it in a file before you quit the pro- 
gram. 

The Storage command is one of the options you saw on the list of 
commands beginning with a slash (/). 

Type the Storage command: 

/S 

It has seven options. These are shown on the Prompt/Error line: 

Storage : L S V U F U D 

The options are: 

L Load File 

S Save Model 

V Save Variables 

U Save Units 

F Save Functions 

# Save/Load DIF™ File (lists only) 

D Delete File 
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Three of these options are discussed in this chapter: L (Load 
File), S (Save Model), and D (Delete File). The other options are 
discussed in later chapters. 

Loading a File 

The Load File option (L) of the Storage command locates a file 
on a diskette, loads the contents into the TK ! Solver program, and 
displays the model on the screen. 

Type: 

L 


The prompt is: 


Load: Filename: 


The cue on the Prompt/Error line prompts you to enter the name 
of the file you want to load. 


Specify a file by typing the filename and entering it with ♦ . If 
you make a mistake while typing the filename, remember that ◄ 
erases the character to the left of the cue. The Instruction Files 
include a file named gravity that is a sample model. 


Type: 

GRAVITY ♦ 

A message on the Prompt/Error line tells you that the program is 
loading the file. 

The model in the file GRAVITY appears on the screen. The screen 
should look like Figure 4-2. 
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(1 r ) Rule: 

v = g*t 




ssssssssss 

========== 

VARIABLE 

SHEET = = = == 

= = = = = *=:=::= = =: 

St Input 

Name 

Output 

Uni t 

Comment 


V 


f t / s 

velocity 


t 


s 

time 


s 


ft 

d i stance 


g 


f t/s A 2 

grav accel 


S Rule 

* v = g * t 

* s = . 5*g*t A 2 

* g = 980.665 11 in cm per second squared 


Figure 4-2 

Look at the right end of the Status line. Because a new model has 
been loaded but not solved, the ! has appeared. 

Saving a File 

The Save Model option (S) of the Storage command saves your 
current model under a filename that you assign. While you are 
working, it is a good idea to save your model from time to time so 
that it is not lost accidentally. If you do not save the model you 
are using when you quit the program, that version of the model 
will be erased. 

Note: The Instruction Files are always available on the 
TKISolver diskette. 

The Save Model (S) and Load File (L) options of the Storage 
command will be especially useful to you as you are working 
through this manual. When you want to stop working for a while, 
save your current model in a file. Then, when you are ready to 
return to the Instruction Manual, load the file and continue. 
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To save a file on a diskette, the diskette must be formatted. If you 
have created an Instruction diskette, it has been formatted and 
can be used to save files. Don’t reformat the Instruction diskette 
or you will erase the files on it. 

The instructions below show you how to save the current model, 
gravity, in a new file on the Instruction diskette. 

Type the Storage command with the Save Model option: 

/SS 

The prompt is: 

Save: Filename: 

A file can have any name you choose, but it must follow the file 
naming conventions of your system as detailed in Chapter 3. 

Name the new file TEST. Type: 

TEST ♦ 

A message on the Prompt/Error line tells you that the program is 
saving the file. 

Note: If your Memory Indicator shows OUT, the program may 
require an hour or more to save a file. You can avoid this by sav- 
ing your model when the LOW message is displayed. Systems 
with low memory capacity will run out of memory sooner than 
systems with more. 

The program saves the gravity model under the filename TEST 
on the Instruction diskette. Notice that the model on your screen 
has not changed. 

If you modify your model and want to save the new version, you 
can save it with a new filename, so that you have copies of both 
versions of the model, or with the same filename, so that the old 
version is erased and you have a copy of the new version only. 

If you save a file using a filename that already exists on the disk- 
ette, the program asks for confirmation of Y or N before saving 
the new model using the old filename. 
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Type: 


/SSTEST ♦ 


The prompt is: 


Overwrite filename: TEST extension: Y N 


Typing Y deletes the old file and saves the new file, and typing N 
cancels the Storage command. TypeN • 

Note: Refer to Chapter 2 for the specific extensions used for 
your system. 

Deleting a File 

The Delete File option (D) of the Storage command deletes from 
the diskette the file you name. Once a file has been deleted, it 
cannot be loaded again; it has been erased. 

Try the Delete File option by deleting your example file TEST. This 
time, instead of typing the filename, try using the Directory 
Scroll feature. 

Type: 

/SD 

When you are prompted for the filename, type: 


The filename that appears on the Prompt/Error line is the first 
filename in the TKISolver directory. 

When you scroll through the TKISolver directory, the filenames 
roll past on the Prompt/Error line, as though a scroll of informa- 
tion were being unwound in front of you. The Directory Scroll 
feature of the Storage command scrolls through the names of the 
TKISolver files. It scrolls in one direction only. 

Note: If your system has a hierarchical directory structure, the 
names of the subdirectories for your current directory scroll past 
after the filenames. See the Hardware Reference Manual for 
more information. 
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The Directory Scroll feature can be used with any of the Storage 
command options and is especially useful if you can’t remember 
the name of a file, or if you want to see what is on a diskette 
without quitting the program to use the operating system. 

Press m again, and the filename of the second file in the directory 
is displayed. 

Repeat pressing * until the filename TEST extension appears on 
the Prompt/Error line. This is the file you want to delete. If you 
scroll past it, press <8>, type the Storage command (/S) and the 
Delete File option (D) again, and scroll through the files until you 
find TEST extension. This is the file to be deleted. Press ♦ to 
choose it as the file you want. 

Note: If you scroll past the last filename, the command stops 
and the prompt disappears. 

Note: If you specify a filename, but do not specify an extension, 
the program responds by displaying the first occurrence of that 
filename with its extension. If the extension is not the correct one, 
press m and the program will find the next occurrence of that 
filename with its extension. When the program finds the correct 
file, press ♦ . 

In all cases, the program requests an explicit confirmation for the 
delete so that you do not delete a file by mistake. In the example, 
the prompt is: 

Delete file: TEST extension : Y N 

Typing Y deletes the file, and typing N cancels the Storage com- 
mand. Type: 

Y 

A message on the Prompt/Error line tells you that the file is being 
deleted. 

Although the file has been deleted, the model is still in the pro- 
gram and remains on the screen. Deleting a file does not affect 
the program. You can continue using the model after the file is 
deleted and you can save it again, if you choose. 
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Conclusion 

This chapter has shown you how to use the Help Facility, and how 
to save, load, and delete files. The next chapter discusses how to 
move around in the TKISolver program. 
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Windows 

The Arrow keys 

The Switch command (;) 

The Goto command (:) 

The Select command ( = ) 

The Window command (/W) 

The Rule Sheet 

The Reset command (/R) — All option (A) 


Models are created in the TK! Solver program by typing and en- 
tering information on the sheets. In order to do this, you must be 
able to move the cursor around the sheets and to display the dif- 
ferent sheets on your screen. 

This chapter is about moving around in the program. It gives in- 
structions for moving the cursor, selecting the sheets you want to 
see on the screen, and clearing the program in preparation for a 
new model. 

You will also be introduced to the Rule Sheet, which contains the 
equations for your model and is used to define the relationships 
between the variables. 


To begin this chapter: 

You should have the TK! Solver program loaded, and the Variable 
and Rule Sheets for the gravity model displayed, as at the end of 
Chapter 4. 

If you quit the program after Chapter 4, load the TK! Solver pro- 
gram and then load the file gravity from the Instruction disk- 
ette. 


The screen should look like Figure 5-1 . 

The remaining figures in this manual are shown without the cur- 
sor. If you want to know where the cursor is, the Position Indica- 
tor in the figure tells you the field that contains the cursor. 
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Figure 5-1 

The Windows 

Below the Message Area on your screen are two windows through 
which TKISolver sheets can be seen. The Variable Sheet is in the 
top window, and the Rule Sheet is in the bottom window. You can 
display any of the TKISolver sheets in either window, or one sheet 
in both windows. You can also manipulate the screen so that there 
is only one window, then split it again so that there are two. 

When you load the TKISolver program, the first sheets on your 
screen are the Variable Sheet in the top window and the Rule 
Sheet in the bottom window. 

Note: When you load a model, the model loads looking as it did 
when you saved it. For example, if when you saved the model the 
Unit Sheet was in a single window, the model loads showing the 
, Unit Sheet in a single window. 
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Moving the Cursor 

The Arrow Keys and the Switch Command 

The cursor shows your current position on the screen. It is moved 
around a sheet with the Arrow keys. For example, pressing <■ 
once moves the cursor one field to the left, and pressing I twice 
moves the cursor two rows down. 

The Switch command (;) moves the cursor between windows. 

Try moving the cursor around both sheets. As you move it, look 
at the Status line at the top of the screen and notice that the Posi- 
tion Indicator, the label, and the information on the Status line all 
change according to the cursor position. 

Move the cursor as far left, right, and up as you can. Notice that 
the cursor stops and you get an error signal at these boundaries. 
Now move the cursor down. As you move the cursor beyond the 
information displayed in the window, the sheet scrolls up to dis- 
play more of the sheet. These two TK! Solver sheets scroll up and 
down; some others scroll for a limited range. 

The Goto Command 

The Goto command (:) provides a quick method for moving the 
cursor to a specific field within a sheet. 

For this example, first move the cursor into the Variable Sheet, 
then type the Goto command: 


The prompt is: 

Goto: Destination or search: 

The cue is on the Prompt/Error line so that you can tell the pro- 
gram where you want the cursor to go. 

To specify a destination, use the row number followed by the first 
letter of the column label for the field you want to go to. 
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For example, move the cursor to the Comment field in row 2 by 
typing: 

2 C ♦ 

Notice that the Position Indicator on the Status line represents 
the cursor position in the same format that is used for the Goto 
command. 

If you type the letter without the number, the cursor moves to the 
specified column within the current row. Move it to the Name 
field in row 2 by typing: 

: N ♦ 

Similarly, if you type the number without the letter, the cursor 
moves to the specified row within the current column. Move the 
cursor to row 7 in the Name column by typing: 

: 7 ♦ 

The Position Indicator is 7n. 

The Goto command is especially useful if you want to move the 
cursor to the top of the sheet or the last row containing an item. 
The top of the sheet is line 1 . Move to the top of the sheet by 
typing: 

: 1 ♦ 

The cursor is now in the first field of the Name column. 

If you type an asterisk (*) instead of a number, the cursor moves 
to the last row on the sheet containing an item. Move the cursor 
to the last item in the Comment column by typing: 

: * C ♦ 

The Goto command can also be used to search for a specific item 
within a column. Typing a quotation mark (”) tells the program 
that you want to search for an item. After the ”, type the item you 
want to find as it appears on the screen, and press ♦ . The Goto 
command searches only within the current column. 
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Note: The item you enter for the search must be exactly what 
you can see on the screen or the program will not be able to find 
it. If the item is longer than the width of the field, enter only that 
portion of the item that is visible. 

The Goto command (:) can be used anywhere on the screen, but 
to see how it works, move the cursor so that the field you are 
going to search for is off the screen. Type: 

: 2 0 ♦ 

Now find the word “time” in the Comment column by typing: 

: " t i me ♦ 

The cursor moves to the field containing the word time. 

The Sheets and the Windows 
The Select Command 

The Select command ( = ) changes the sheet in the window con- 
taining the cursor. The cursor is currently in the top window. Se- 
lect a different sheet for that window by typing: 


The message is: 

Sheet: VRUGLFPT 


These options represent the titles of the TK! Solver sheets: 


Option 

V 

R 

U 

G 

L 

F 

P 

T 


Sheet 

Variable Sheet 
Rule Sheet 
Unit Sheet 
Global Sheet 
List Sheet 

User Function Sheet 
Plot Sheet 
Table Sheet 


Select the Unit Sheet for the top window by typing: 
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The screen should look like Figure 5-2 with the Unit Sheet in the 
top window. The Unit Sheet is discussed in the next chapter. 
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Figure 5-2 

The Window Command 

The Window command (/W) changes the screen from two win- 
dows to one, showing the sheet containing the cursor, or from one 
window to two, showing both the sheet currently containing the 
cursor and another that you choose. To see how it works, type: 

/W 

With one exception, the options are the same as those for the Se- 
lect command ( = ). The message is: 

Window: 1 VRUGLFPT 

The only difference is the option 1. When the screen is split into 
two windows, this option is the only one you can use with the 
Window command (/W). It changes the screen from two win- 
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dows to one window showing the sheet containing the cursor. The 
cursor was in the Unit Sheet when you typed /W, so the Unit 
Sheet will be the sheet displayed in the one window. Type: 

1 

The screen should look like Figure 5-3. There is now one window 
containing the Unit Sheet for the gravity model. 
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Figure 5-3 


Select the Rule Sheet for the window by typing the Select com- 
mand: 

= R 

Now change the screen back to two windows with the Window 
command. The top window will contain the current sheet, the 
Rule Sheet. Type: 

/W 
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The remaining options for the Window command represent the 
titles of the TKISolver sheets. When you split the screen into two 
windows, the program needs to know which sheet you want in the 
bottom window. Display the Variable Sheet in the bottom win- 
dow by typing: 

V 

The screen should look like Figure 5-4. These are the same sheets 
you saw at the beginning of the chapter, but now they are in dif- 
ferent windows — the Rule Sheet in the top window and the Vari- 
able Sheet in the bottom window. 

( 1 i ) Input : 

S Rule 
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* s= . 5*g*t A 2 

* g=980.665 H in cm per second squared 


St Input 
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Figure 5-4 

The Rule Sheet 

Now that you know how to move around, let’s take a more de- 
tailed look at the Rule Sheet. 

The Rule Sheet contains the equations that establish the relation- 
ships between the variables. It has two columns, the Status col- 
umn on the left and the Rule column on the right. 
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The Status Column 

The Status column contains output fields. This means that only 
the program can generate information in this column; you cannot 
enter anything there, although you can move the cursor to the 
column to look at status messages. 

In the gravity model, the Status fields for all of the equations 
contain asterisks (*). The * is the symbol the program uses to tell 
you that the rule, or equation, is unsatisfied. Move the cursor 
over one of the asterisks and look at the Status line at the top of 
the screen. The message is: 

Status: ★ Unsatisfied 

When a model is solved, the Status fields for the satisfied equa- 
tions are blank and the message on the Status line is Satisfied. 

The other character the program uses in the Status column is the 
greater than symbol (>). If you made an error in the model, when 
you try to solve it the program generates a > next to the equation 
found to be in error. You can look at the error message just as you 
looked at the one for the unsatisfied equation by moving the cur- 
sor to the Status field containing the symbol and looking at the 
Status line. 

The Rule Column 

The Rule column contains the rules. All rules must be equations 
composed of expressions. TK! Solver expressions have the same 
form as algebraic expressions. 

You can enter one rule per row. Variable names must begin with a 

letter or one of the special characters @, #, $, %, or and may 

contain letters, numbers, and those special characters. 

If you want to put a comment on the Rule Sheet, you can enter it 
following a rule or instead of a rule by typing a quotation mark 
(”) and then the comment. When the program is solving a model, 
it ignores anything in a row after a quotation mark. 
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Because most keyboards do not have all the standard symbols 
used for mathematics, the TKiSolver program uses computer 
conventions for standard arithmetic operators. These operators 
are: 

Operator TK ! Solver Symbol 

4 - + 

X 

exponent 

Note: Multiplication must always be specified with *. The 
TKiSolver program does not assume multiplication. For exam- 
ple, the equation ab + ac = a(b + c) must be entered as 
a*b + a*c - a*(b + c). The program considers ab and ac to be 
variable names and a§ to be a function. 

Note: Scientific notation using E may be used instead of the ex- 
ponent A , if desired. 

Note: When solving an equation, the TKiSolver program first de- 
termines whether values are positive or negative and then solves 
the equation from left to right in this order of precedence: ex- 
ponentiation, multiplication and division, addition and subtrac- 
tion. 

There are many functions built into the TKiSolver program. 
Some are standard mathematical functions, such as sine and tan- 
gent , and others are functions that have been created for the 
TKiSolver program, such as pi and dot. The Reference Manual 
contains a complete list of the built-in functions available and the 
syntax of each. 

You may also define your own functions. This program feature is 
described in Chapter 16. 


* 

/ 

A 
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Note: The program does not distinguish between uppercase and 
lowercase characters when looking at the names of TKISolver 
built-in functions; you can enter the TKISolver names for the 
built-in functions in both uppercase and lowercase characters. 
The program distinguishes between uppercase and lowercase for 
all other names and functions in the program. 

When using functions in TKISolver rules, the syntax is: 

Ax) 

For example: 
sin(x) 

Resetting the Program 

The next chapter shows you how to begin building a model. The 
model you will use is a new one that is used throughout the man- 
ual to show you a variety of TKISolver features and commands. 
Before loading the new model, you must reset the program and 
clear the gravity model from the screen. 

The Reset command (/R) resets all or part of the program with- 
out quitting it. Type: 

/R 

The message is: 

Reset : V S A 

The three Reset options are: 

Option Action 

Variable Value (V) Resets all values on the Variable Sheet 
Sheet (S) Resets the sheet currently containing the 

cursor. 

All (A) Resets the entire program. 


The Variable Values (V) and Sheet (S) options are explained in 
Chapter 7. For this example, use the All option (A) to reset the 
program, clearing all the sheets. Type: 
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The message is: 

Reset all: Y N 

So that you don’t reset the program by accident and lose your 
model, each Reset option requires a confirmation of Y before the 
program is reset. Typing N cancels the Reset command. Type: 

Y 

The TKISolver program has been reset and is cleared of the grav- 
ity model. The screen looks as it did when you first loaded the 
program, with a blank Variable Sheet in the top window and a 
blank Rule Sheet, containing the cursor, in the bottom window. 
You can now enter or load a new model. 

Conclusion 

This chapter has explained how to move around the TKISolver 
program and introduced the Rule Sheet. The next chapter shows 
how to enter items and begin building a model. 
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Chapter 6 Building a Model 

• The travel model 

• Types of fields 

• Entering equations 

• Automatic variable entry 

• Merging files 

• The Variable Sheet 

• The Variable subsheet 

• The Dive command ( > ) 

• The Return command ( < ) 

• The Unit Sheet 

To use the TK! Solver program to solve a model, you must first 
enter the model on the TK! Solver sheets. Which sheets you use 
depend on which features of the program your model requires. 
Most models will use at least the Rule and Variable Sheets because 
the Rule Sheet holds the equations that define variable relation- 
ships, and the Variable Sheet holds information about the vari- 
ables. 

Any model that requires conversions for units of measurement 
also needs the Unit Sheet. Unit conversions are defined on the 
Unit Sheet, and the program needs these conversion definitions 
to convert values from one unit to another. 

The Rule Sheet was introduced in Chapter 5. This chapter intro- 
duces the Variable and Unit Sheets and gives instructions for 
building a sample model named travel, travel is a simple 
model and is used through the rest of this manual to show you 
how to build a model and expand it using the various TK! Solver 
features. 


To begin this chapter: 

The program should be reset with the Variable Sheet in the top 
window and the Rule Sheet in the bottom window, both blank, as 
at the end of Chapter 5. 

If you quit the program after the Chapter 5, load the program. 
The screen should look like Figure 6-1. 


6-1 




TKISolver Instruction Manual 


( 1 r ) Rule: 

For Help, type ? 

rs:s:::ssss:rr:;:;:; VARIABLE SHEET ================: 

St Input Name Output Unit Comment 


S Rule 


Figure 6-1 

The Travel Model 

The travel model is a simple model that finds the length and 
cost of a trip by car. It defines the relationships between mileage, 
speed, distance, gas price, and the cost of a trip. The model uses 
three equations. While you are working through this chapter, you 
will enter the equations on the Rule Sheet, the characteristics of 
the variables on the Variable Sheet, and unit conversion defini- 
tions on the Unit Sheet. 

Types of Fields 

As you saw in the examination of the Rule Sheet, you cannot en- 
ter information in all fields. Output fields, such as in the Status 
column on the Rule Sheet, can contain only information genera- 
ted by the program. The TKISolver program has two other kinds 
of fields, entry fields and option fields. 

In option fields, you can type only one of a limited set of charac- 
ters. The characters that can be typed as options and what they 
mean differ according to the field and the sheet. Option fields are 
discussed individually as part of the sheet descriptions. 
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The items that you type and enter go into entry fields. The cursor 
marks your current position on the screen. If the cursor is in an 
entry field, when you type a character that character appears in 
the field. When you have finished typing the item that you want 
in the field, you enter it by pressing either ♦ or an Arrow key. 

For example, the Rule column on the Rule Sheet consists of entry 
fields. If the cursor is not in the first Rule field, move it there, 
then type the characters mlg. 

A cue has appeared in the field, like the one that appeared on the 
Prompt/Error line when you were prompted for a filename in the 
Storage command (/S). The cue marks your position in the field. 

Entering Equations 

The TRAVEL model has three equations. They are: 

mlg = d/gas 
s = d/t 

cost=pr*gas 

As you can see, the characters that you just typed form the first 
variable name in the first equation. This equation states that 
mileage is equal to distance divided by the amount of gas. The 
variable mlg stands for mileage, d for distance, and gas for 
amount of gasoline. Finish typing the equation so that it looks 
like the equation below. If you make a typing mistake, remember 
that ◄ erases the character to the left of the cue. 

m lg = d/gas 

(Equation 1) 

When you have typed the equation correctly, enter it by pressing 
♦ . The cue disappears, and the equation is displayed on the 
Status line at the top of the screen. 

The screen should look like Figure 6-2. Notice that each of the 
variable names in the equation has been entered on the Variable 
Sheet in the column labeled Name. 
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(1 r ) Rule: m L g = d / gas 

VARIABLE SHEET ================ 

Output Unit Comment 


S Rule 
* mlg=d/gas 


Figure 6-2 

Move the cursor over the asterisk (*) on the Rule Sheet and look 
at the top of the screen. The message on the Status line says the 
equation is Unsatisfied. 

Move the cursor over and down into the second field in the Rule 
column and enter Equation 2. The variable s stands for speed, 
and t for time. The variable d is the same as in Equation 1 . Type: 

s = d / 1 ♦ 

(Equation 2) 

The screen should look like Figure 6-3. 

This is a good time to save the model in a file. Using the Storage 
command (/S), save the model on the Instruction diskette using 
the filename travel. Type: 

/SS 

At the prompt type: 

TRAVEL ♦ 

When the message disappears, the file has been saved. 


St Input Name 
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(2 r ) Rule: s = d/ 1 



VARIABLE SHEET ============ 

Output Unit Comment 


RULE SHEET ==================== 



Automatic Variable Entry 

The two new variable names from the second equation were in- 
serted automatically on the Variable Sheet just as the first ones 
were. This automatic feature is controlled through the Global 
Sheet. Call the Global Sheet into the bottom window by typing: 

= G 

The Global Sheet is made up of labeled lines, each of which is 
associated with one field. The first field, labeled Variable Insert 
ON, is the switch that controls the automatic entry of variables 
and is an option field. If it is set to Yes, variable names are auto- 
matically entered on the Variable Sheet in the Name column when 
they are entered on the Rule Sheet as part of an equation. 

When the program is loaded, this field is set to Yes. If you want to 
insert variables by hand, you can change this field to No by typ- 
ing N. Typing Y returns it to Yes. 

Note: This manual assumes throughout that the Variable Insert 
ON field is set to Yes. 
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Other fields on the Global Sheet set specifications for the solvers 
and the printer. The Global Sheet is discussed in more detail in 
Chapters 9 and 12. Call the Rule Sheet back into the bottom win- 
dow with the Select command ( = ). Type: 

= R 

Merging Files 

It is possible to load more than one file at a time, merging them to 
create a single model. The last equation for travel is an Instruc- 
tion File named COST. Load COST into the existing model using 
the Storage command (/S). Type: 

/SL 

At the prompt, type: 

COST 

The screen should look like Figure 6-4. Notice that the new file 
added information on the Variable Sheet as well on the Rule 
Sheet. Only the two new variable names were added to the exist- 
ing list. When files are merged, the program does not duplicate 
variables, and it coordinates the current information with the 
new information. Items on the Rule Sheet and Unit Sheet, how- 
ever, are duplicated if they appear in both the current model and 
the merged file. You will see an example of this later in this man- 
ual. 

Note: The information in the file COST has been merged with 
the travel model, but the file COST itself is unaffected. 

Having added the equations and variables from the file COST to 
the model, save the file again using the same name, TRAVEL. This 
time the program asks if you want to overwrite the existing file 
named travel. Because you are saving a newer version of the 
model, you do want to overwrite the old file. Respond to the mes- 
sage by typing Y. This causes the program to delete the old infor- 
mation in the file travel and replace it with the new 
information. 
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Figure 6-4 

Let’s take a closer look at the Variable Sheet while entering some 
information for the travel model. 


The Variable Sheet 

The Variable Sheet contains characteristics of the variables. Each 
row describes one variable, and each column lists a particular 
characteristic of the variables. There are six columns on the Vari- 
able Sheet, and, therefore, six characteristics shown for each 
variable. 

The Status Column — Output Fields 

The first column on the left is the Status column. Each Status 
field is both an output and an option field. If the value of a vari- 
able causes an error during solution, the program generates the 
symbol > in the Status field. When the cursor is moved over the 
error symbol, an error message is displayed on the Status line at 
the top of the screen. 

The use of Status fields as option fields is explained at the end of 
this section. 
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The Input Column 

The column to the right of the Status column is the Input column. 
The Input fields are entry fields that contain the input values for 
the variables. Values must be numbers or expressions that the 
program can evaluate. 

Values on the Variable Sheet are shown rounded to fit the field 
width. If you move the cursor to a field containing a value, the 
value is shown on the Status line to the full accuracy of 12 signifi- 
cant digits. All calculations use full accuracy. For the range of 
values accepted by your system, see the Hardware Reference sec- 
tion of the Reference Manual. 

Symbolic values must begin with an apostrophe (’). For a more 
detailed explanation of values used with the TKiSolver program, 
see the Reference Manual. 

The fields in the Input column can act as a calculator to evaluate 
expressions. For example, move the cursor to the Input field next 
to mlg and type: 

40 ♦ 

The value 40 is entered in the field and appears on the Status line 
at the top of the screen. 

Now change the value in the Input field by typing: 

20-5 ♦ 

The program evaluates the expression in the Input field and pro- 
duces the value 15 as the mileage. In the TKiSolver program, any 
field that can contain input values can also evaluate expressions. 

Now move the cursor down to the next Input field. Suppose you 
used 5 gallons of gas and want to determine the distance trav- 
elled. Enter an expression. Type: 

m L g * 5 ♦ 

Because mlg has a value, the program can evaluate the expression 
and enters the value 75 in the Input field. 
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The Name Column 

The next column to the right is the Name column. Variables are 
associated with the rules through the variable names. The Name 
column contains the seven variable names for the model travel. 
Name fields are entry fields. Variable names must begin with a 

letter or one of the special characters @, #, $, %, or , and may 

contain letters, numbers, and those special characters. 

The Output Column 

The Output column, to the right of the Name column, is where 
the program displays the values determined when the model is 
solved. 

The Unit Column 

The Unit column is next and contains the units of measurement 
for the variables. Although only one unit is displayed for each 
variable on the Variable Sheet, there are actually two units for 
each variable, a Calculation unit and a Display unit. 

The first unit name you enter for each variable in its Unit field 
becomes the Calculation unit. The Calculation unit is the unit as- 
sumed for the variable when it appears in a rule. All calculations 
and unit conversions done internally use the variable value in the 
Calculation unit. It is essential to set Calculation units if you are 
using rules that require compatible units and you want to display 
the values in different units. 

For example, look at the first equation on the Rule Sheet: 
m l g = d / g a s 

If mlg is to be calculated in miles per gallon, you must calculate d 
in miles and gas in gallons, otherwise the program cannot calcu- 
late the values correctly. If the Calculation unit for d is in feet and 
for gas is in liters, the program can solve the model, but the out- 
put values would not correctly reflect the equation. As long as the 
Calculation units are compatible, the Display unit can be feet for 
d and liters for gas or any other units whose conversion has been 
defined on the Unit Sheet. 
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The Display unit is the unit you see on the screen. It may be the 
same as the Calculation unit. To change the Display unit, you 
simply enter a new unit name. The new unit entered becomes the 
Display unit, but the Calculation unit remains the one you origi- 
nally entered for the variable. You will see how to change a Calcu- 
lation unit later in this chapter. 

Note: The program stores all values in the Calculation unit. If 
you use a variable name as part of an expression to be evaluated, 
the program uses the value of the Calculation unit, not the Dis- 
play unit. When your values are displayed in mixed units, you 
should make cautious use of the calculation feature of entry 
fields. 

The travel model requires several different units for the differ- 
ent variables. First, enter the Calculation units for the variables 
in the model. 

The Calculation unit for mlg is mi/gal. Move the cursor to the 
Unit field for the variable mlg and enter the Calculation unit by 
typing: 

m i / g a l ♦ 

Enter the remaining Calculation units in the same way, giving d 
the unit mi, s the unit mi/h, and / the unit h. 

Note: Be careful to enter only one unit name per field. If you 
make a typing error, use either ◄ or ® to correct your error. The 
first unit name you enter, even if it is in error, becomes the Calcu- 
lation unit. The section below about the Variable subsheet shows 
you how to change a Calculation unit. If you accidentally enter 
an incorrect Calculation unit, you will be able to correct it while 
working on that section. 

Suppose you want the Display unit for mlg to be km/1. With the 
cursor in the Unit field for the variable mlg type: 

km/ L ♦ 

When you entered the new Display unit, the program displayed a 
question mark next to the value in the Input field. Unit conver- 
sions must be defined on the Unit Sheet before the program can 
perform a unit conversion, and you have not yet filled in the Unit 
Sheet. The program displays a question mark next to the value to 
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tell you that the unit conversion has not been defined and it does 
not have enough information to make the conversion from the 
Calculation unit, mi/gal, to the Display unit, km/1. Leave the 
units as they are for now. They will be used later in an example. 

The Comment Column 

The Comment column provides a space for you to keep notes and 
comments about the variable in that row. It is ignored by the 
solvers. 

The Comment column for travel contains comments about the 
three variables, gas , cost , and pr ; that were loaded from the file 
COST. 

Move the cursor to the Comment field for mlg and type the com- 
ment: 


mi L e a g e 


Instead of pressing ♦ to enter the comment, press I . The com- 
ment is entered and the cursor moves down to the next field. 
When you are in an entry field, the Arrow keys both enter infor- 
mation and move the cursor. 


Fill in the rest of the comments that are missing: 


Variable 

d 

s 

t 


Comment 

distance 

speed 

time 


The screen should look like Figure 6-5. 


The Status Column — Option Fields 

Now that you are more familiar with the Variable Sheet, let’s re- 
turn to the discussion of the Status fields and their use as option 
fields. A Status field on the Variable Sheet has five options avail- 
able that affect the variable in that row. 


To enter an option, simply move the cursor to the Status field in 
the appropriate row and type the letter representing the option 
you want. Options do not require ♦ . 
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(5c) Comment: time 
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speed 
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cost 


$ 
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$ 
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S Rule 


RULE SHEET 


★ m l g = d / g a s 

★ s=d/t 

★ cost=gas*pr 


Figure 6-5 


Options available for the Status column on the Variable Sheet 
are: 


Option 

Input (I) 

Output (O) 
List (L) 
Guess (G) 

Blank (B) 


Result 

Moves the output value to the Input field. Deletes 
Guess option (G). 

Moves the input value to the Output field. Deletes 
Guess option (G). 

Associates the variable with a List of values. (See 
Chapter 13.) Can coexist with Guess option (G). 
Designates the input value as the first guess for an 
iterative solution. (See Part III.) Can coexist with 
List option (L). 

Blanks the variable value. 


Use the Blank option (B) to erase the Input value for mlg. Move 
the cursor to the Status field for mlg and type: 


B 

Blank out the Input value for d by the same method. 


Chapter 6 
Building a Model 


Note: The program remembers the last value that was blanked. 
That value can be returned to the screen if you type the Input (I), 
Output (O), or Guess (G) option in the Status field when the In- 
put and Output fields are blank. 

The Variable Subsheet 

Several of the TK! Solver sheets have subsheets that show an ex- 
panded amount of information. The Variable Sheet is one of 
these. For each variable there is a subsheet that lists all of the 
characteristics of that variable. It is another way of looking at the 
variable. 

The Dive Command ()) 

Subsheets are called with the Dive command (>). This command 
replaces the Variable Sheet with the subsheet for the variable in 
the row containing the cursor. 

For example, display the Variable subsheet for the variable mlg 
by moving the cursor into the row containing mlg and typing: 

> 

The screen should look like Figure 6-6. The Variable Sheet is re- 
placed with the subsheet for the variable mlg. 


(s) Status: 

==================== VARIABLE: mlg 

Status : 

First Guess: 

Assoc i ated List: 

I npu t Value: 

Output Value: 

DisplayUnit: km/l 

Calculation Unit: mi/gal 

Comment : mileage 


==================== rule SHEET == 

S Rule 

★ m l g = d /gas 

★ s=d/t 

★ cost=gas*pr 


Figure 6-6 


6-13 


TKISolver Instruction Manual 


Instead of columns and rows of fields, this sheet consists of la- 
beled lines, each of which has one field associated with it. There 
are only eight fields on the sheet. 

The Status, Input, Output, and Comment fields show the same 
information as those on the Variable Sheet. The only difference 
in these fields is that the values displayed on a Variable subsheet 
are shown rounded to 10 significant digits. 

The First Guess field sets a default first guess for iteration. 
TKISolver iteration is discussed in Chapters 10 through 12. 

The Associated List field names the list of values associated with 
the variable. If there is an associated list, the Status field is set to 
L. Lists are discussed in Part IV. 

There are two unit fields, one for the Display unit and one for the 
Calculation unit. As you can see, they are different for mlg. It is 
unlikely you would want to change the Calculation unit once 
your model is built, but if you wanted to change it, it is best to 
dive to the subsheet and change the unit name in the Calculation 
Unit field. 

Note: If you made a mistake entering any of your Calculation 
units for travel, you can correct them by diving to the subsheet 
for that variable and changing the Calculation unit there. 

Note: If you set the Calculation unit on the subsheet, the pro- 
gram does not assume a Display unit as it does when the Calcula- 
tion unit is set on the Variable Sheet. 

The Position Indicator is different on the Variable subsheets than 
on the Variable and Rule Sheets. It consists of a single letter ident- 
ifying the field. The Goto command (:), therefore, requires only 
the identifying letter to locate a field. 

For example, move the cursor to the Display Unit field by typing: 
: D ♦ 

If you change an item on this sheet, the change is reflected on the 
Variable Sheet. To make the Display and Calculation unit the 
same for mlg, change the Display unit by typing: 

m i / g a l ♦ 
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The Return Command (<) 

The Return command (<) moves you from the subsheet back to 
the previously displayed sheet. Return to the Variable Sheet to 
look at the change you have made by typing the Return com- 
mand: 

< 

Notice that the cursor is in the same field as it was when you typed 
the Dive command (>). If you had wanted to move from the sub- 
sheet to another sheet, you could have done so by using the Select 
command ( = ) instead of the Return command (<). 

The Unit field for mlg displays mi/gal. 

The Unit Sheet 

The Unit Sheet is where you enter the definitions that enable the 
program to convert values from one unit of measurement to an- 
other. Although units have been entered on the Variable Sheet, 
the program cannot convert values until you define the conver- 
sions on the Unit Sheet. 

A Unit Sheet with the conversions already defined for TRAVEL is 
in a file on the Instruction diskette. When this file has been 
loaded and merged with travel, the model will be ready to use. 

Use the Select ( = ) and Window (/W) commands to display the 
Unit Sheet in a single window. Type: 

= U 
/ W 1 

Note: You don’t have to display a particular sheet when you 
load a file, but you have been asked to display the Unit Sheet here 
so that you can see what happens when you load the file. 

The file is named tunits. Load it from the Instruction diskette 
using the Load option (L) of the Storage command (/S). Type: 

/S L 

At the prompt, type: 

TUNITS ♦ 


TKISolver Instruction Manual 


The screen should look like Figure 6-7. Use the Storage com- 
mand (/S) with the Save Model option (S) to save travel again 
so that your saved model contains the units. 


(If) From: mi 


From 

To 

Multiply By 

m i 

k m 

1 .609 

m i / h 

km/h 

1 .609 

mi /gal 

km/ l 

. 4251 

ga l 

l 

3.785 

h 

m i n 

60 

C 

F 

1 .8 


UNIT SHEET ============ 

Add Offset 


32 


Figure 6-7 

The TK!Solver program uses the Unit Sheet to convert values 
wherever a unit conversion is desired. All unit conversions must 
be defined on this sheet. 

All fields on the Unit Sheet are entry fields. The Multiply By field 
is the conversion factor that relates the units in the From and To 
fields. The From field names the unit from which the factor con- 
verts and the To field names the unit to which the factor converts. 
The Add Offset field contains the offset factor for conversion if 
one is required; otherwise it remains blank. 

You may name your units anything you choose. Unit names can 
be created from all printable characters, including blanks, but 
blanks at the beginning or end of a unit name are deleted when 
the name is entered. 

The conversion factors are also up to you. If you define the con- 
version incorrectly, the conversions made by the program will be 
incorrect. 
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Use the Window command (/W) to split the screen and look at 
the Variable Sheet to see which units have had conversions de- 
fined. Type: 

/W V 

As you can see, all units have at least one conversion defined on 
the Unit Sheet except for $. 

Suppose a trip is taking you from America to Germany, and you 
want to know the conversion of price and cost from American 
dollars to Deutschmarks. Assume for this example that the rate 
of exchange is .44 DM to the American dollar. 

Move the cursor into the Unit Sheet, then move it to the last row 
containing an item by typing: 

: ★ ♦ 

Move the cursor down into the first blank row, then type $ in the 


From field. Use * to enter the unit and move the cursor. Enter 
the unit DM in the To field and the conversion factor .44 in the 
Multiply By field. 

( 7m ) Mu L t 

i ply By: 

.44 



========= 

========= 

= = UNIT SHE 

ET ===== 

it 
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Figure 6-8 
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You have defined the conversion for the units $ and DM and the 
screen should look like Figure 6-8. The Unit Sheet and unit con- 
versions are discussed in more detail in Chapter 8. 

Save travel again. Type: 

/SS 

At the prompt, type: 

TRAVELS 

Confirm the overwrite by typing Y. 

Conclusion 

You have just built the model TRAVEL using information from a 
variety of sources, and the model is ready to be used. You may 
want to quit the TKiSolver program and make a backup copy of 
your file travel using your operating system. The next chapter 
shows you how to solve some problems using the model. 


6-18 


Chapter 7 

Solving a Model 


Chapter 7 Solving a Model 

• Solving a problem 

• The Action command (!) 

• Underdefining a model 

• Changing the values 

• The Storage command (/S) — Save Variables option (V) 

• The Blank command (/B) 

• The Reset command (/R) — Sheet option (S) 

• The Delete command (/D) 

• The Reset command (/R) — Variable Values option (V) 

• Overdefining a model 

• Changing the model 

• The Insert command (/I) 

• The Edit Field command (/E) 

Now that you have created a model, you can solve a variety of 
problems concerning the variables in the model. You can also edit 
the model by adding, deleting, or changing rules, and by chang- 
ing the input values and variables. 

In this chapter, you will begin using the travel model to solve 
several simple problems. The chapter then shows you how to 
change the model to solve a more complex set of problems. 


To begin this chapter: 

At the end of Chapter 6, the screen was split with the Unit Sheet 
for travel in the top window and the Variable Sheet in the bot- 
tom window. Use the Select command ( = ) to display the Rule 
Sheet in the top window so that the screen is split with the Rule 
Sheet in the top window and the Variable Sheet in the bottom win- 
dow. 

If you saved the travel model and quit the program at the end of 
the last chapter, load the program, then use the Storage command 
(/S) to load the file travel. The Unit Sheet should be in the top 
window and the Variable Sheet in the bottom window. Use the 
Select command ( = ) to put the Rule Sheet in the top window. 

The screen should look like Figure 7-1. 
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(1 r) Rule: m lg=d/gas 

S Rule 

★ m lg = d/gas 

★ s=d/t 

★ cost=gas*pr 


= = = =: = = = = = = = =:=:=: = =:=: = =:= VARIABLE SHEET = = = = = = = 
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$ 
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Figure 7-1 


Solving a Problem 

This is the first problem you will solve using the travel model: 

If your car gets 27 miles to the gallon, and the price of gasoline is 
$ 1.25 a gallon, how far can you travel on $10 worth of gasoline? 

On the Variable Sheet, enter the value 27 for the variable mlg by 
moving the cursor to the Input field beside the variable and typ- 
ing: 

27 ♦ 

Now enter the values 10 in the Input field for cost and 1 .25 in the 
Input field for pr. Notice that the values entered are in the Display 
units. 

The Action Command (!) 

The exclamation point (!) is the Action command, and it works 
differently on different sheets. If the cursor is in any field in the 
Variable or Rule Sheet and the Action command (!) is typed, the 
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program attempts to solve the model. You must hold down the 
Shift key while typing the exclamation point. Solve the model by 
typing: 

! 

The screen should look like Figure 7-2. Output values have been 
solved for the two variables d and gas. With the given input 
values, you could go 216 miles on 8 gallons of gasoline. 


(7i) Input: 1.25 
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Figure 7-2 



Underdefining a Model 


The values for s and t were not solved, and, as you can see by 
looking at the Rule Sheet, the one equation containing those vari- 
ables remains unsatisfied. The model is underdefined because 
there are not enough input values given for the program to com- 
pletely solve the model. The values for s and t remain blank. 


Enter the value 55 in the Input field for the variable 5 and type the 
Action command (!) again. This time a value is solved for t , and 
all the equations are satisfied. 
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You may have noticed that while the program was solving the 
model, a message appeared on the Prompt/Error line: 

Direct Solver 

The Direct Solver is one of the TKiSolver program’s methods of 
solution. The program can also solve problems by an iterative 
method using the Iterative Solver. The concept of iteration and 
the use of the Iterative Solver are discussed in Part III. 

Move the cursor over the Output field for t and look at the Status 
line. Notice that on the Variable Sheet, the value for t is rounded 
to fit the width of the column while on the Status line the value is 
shown to the full accuracy of 12 digits. 

Changing the Values 

There are three ways to change an item in an entry field: 

• Enter a new item, replacing the existing item in the field. 

• Blank the existing item. 

• Edit the existing item. 

Suppose you now have $50 to spend instead of $10. Change the 
value for cost to 50 by moving the cursor to the Input field for 
cost and entering the new value. When you press ♦ or an Arrow 
key, the new value replaces the old one. Any item in an entry field 
can be changed in this way. 

When you changed the value, the Solution Indicator on the right 
end of the Status line reappeared. When a model is changed, the 
program does not automatically solve it again. You must type the 
Action command (!) again to solve it. 

Solve the model with the new value by typing: 

! 

The screen should look like Figure 7-3 with all the output values 
changed. The Solution Indicator on the Status line disappears 
when the model is solved. 
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(6i) Input: 50 
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The Storage Command— Variables Option (V) 

The next sections of this chapter show you how to blank fields 
and delete rows. It uses the Variable Sheet for examples, so before 
you begin blanking parts of your model, save the current Variable 
Sheet. Then you can load it later and use it again. 

You can save the variables using the Save Variables option (V) of 
the Storage command (/S). Your cursor can be on any sheet, but 
only the Variable Sheet is saved. Because subsheets are just an- 
other way of looking at the information on the Variable Sheet, 
any subsheets that are associated with the Variable Sheet are 
saved along with the Variable Sheet. Type: 

/SV 

At the prompt, enter the filename tvar. The variables for 
travel are now saved in the file tvar. 
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The Blank Command 

You have used the Blank option (B) in the Status column to blank 
values on the Variable Sheet. The Blank option (B) is used to 
blank values only on the Variable Sheet. There are two other ways 
to blank an entry field that can be used on any sheet: the Reset 
command (/R) that you used in Chapter 5, and the Blank com- 
mand (/B). 

The Blank command (/B) is used to blank a specific field or col- 
umn of fields. For example, to blank the variable name for 5 , 
move the cursor to the Name field for s and type: 

/B 

The prompt is: 

Blank: Point to last field (4n) 

If you wanted to blank a column of fields, you would use the 
cursor to point to the last field you wanted to blank. Blank just 
the name s by typing: 

♦ 

The name disappears from the screen. 

Now blank a column of fields. Move the cursor to the top of the 
Input column and type: 

/B 

At the prompt, use the cursor to point to the last item in the Input 
column. Notice that as you move the cursor, the number and let- 
ter in parentheses at the end of the prompt message changes to 
reflect the cursor position. The Position Indicator on the Status 
line does not change, but reflects the original cursor position. 
When you have moved the cursor to the last item in the Input 
column, press ♦ . 

The screen should look like Figure 7-4. All of the input values 
were blanked, and the cursor returns to the field in which you 
originally typed the Blank command (/B). 
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Figure 7-4 


The previous values are still available, however. Move the cursor 
to the Status field for the variable cost and type I. The last value 
reappears in the Input field. The Status field options Input (I), 
Output (O), and Guess (G) all return the most recent value. 

You can use the Goto command (:) with the Blank command. 
Move the cursor to the top of the Unit column and type /B. At 
the prompt, point to the bottom of the Unit column by typing: 

: * ♦ 

A message returns requiring a confirmation of the cursor posi- 
tion. Press <► to confirm, and the entire Unit column is blanked. 

Note: If you use the Blank command (/B) in a Unit field on the 
Variable Sheet, both the Calculation and Display units are 
blanked. 

The Blank command (/B) does not work on output fields. 
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The Reset Command— Sheet Option (S) 

There is another way to reset the screen. In a previous chapter, 
you used the All option (A) of the Reset command (/R) to reset 
the program, clearing all the sheets. The Sheet option (S) resets 
only the sheet containing the cursor. 

With the cursor on the Variable Sheet, type: 

/RS 

Confirm the command by typing Y. 

The Variable Sheet is reset and is now blank, but the Rule Sheet 
remains as it was. With the Select command ( = ), call the Unit 
Sheet into the bottom window and notice that it also has not 
changed. The Sheet option (S) of the Reset command (/R) affects 
only the sheet containing the cursor; the rest of the model is unaf- 
fected. 

Let’s look at what happens if two files containing the same infor- 
mation are merged. With the travel model still loaded, load the 
file travel again. 

Use the cursor to scroll through the Variable and Unit Sheets and 
notice that the variables have not been duplicated, but the units 
have. 

Use the Select command ( = ) to call the Rule Sheet into the top 
window and scroll through it. The rules have duplicated as well. 
Rules and units are loaded as they were saved with no check for 
duplication. 

The values for the variables were blanked because the model you 
loaded had blank variable values. When you merge models, the 
items on the Variable Sheet in the new model are merged with 
those in the old model, but if any items are in conflict, such as 
variable values, the item in the model being loaded takes prece- 
dence. 

The Delete Command 

Because we are using a simple model, the duplicated rules and 
units can be easily identified. You may sometimes want to keep 
duplicated rules and units on your sheets, but if not, you can de- 
lete them using the Delete command (/D). 
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The Delete command (/D) is similar to the Blank command (/B), 
but instead of blanking fields, the Delete command (/D) deletes 
entire rows on a sheet. In this example, you will delete the dupli- 
cated rules and units. 

The first three equations on the Rule Sheet are the original 
travel equations, so it is the last three that we want to delete. 
With the cursor in the Rule Sheet, move the cursor to the fourth 
row by typing: 

: 4 ♦ 

Type the Delete command: 

/D 

The prompt is: 

Delete: Point to last row (4r) 

As with the Blank command (/B), you can delete one row by typ- 
ing ♦ or you can move the cursor to the end of a block of rows 
and delete the entire block. Type: 

: * ♦ 

When the prompt reappears, press ♦ to confirm the cursor posi- 
tion, and the three duplicated equations are deleted. 

Note: When a rule is deleted on the Rule Sheet, the variables 
used in that rule are not deleted, but remain on the Variable 
Sheet. 

Use the Select command ( = ) to call the Unit Sheet into the top 
window and use the Delete command (/D) in the same way to 
delete all the items on the sheet from row 8 through the last row 
on the sheet. 

Fill in the variables by loading the file you saved earlier named 
TVAR. Use the Load option (L) of the Storage command (/S). 
When the file has been loaded, your screen should look like Fig- 
ure 7-5. 
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1 080 

m i 

distance 


gas 

40 

ga L 

amount of g 

55 

s 


m i / h 

speed 


t 

19.636364 h 

t i me 

50 

cost 


$ 

cost of t r i 

1 .25 

pr 


$ 

price of ga 


Figure 7-5 


The Reset Command— Variable Values Option (V) 

Below is a new problem designed to show you what happens if 
you overdefine a model. Before trying the new problem, reset all 
the variable values used in the first problem using the Variable 
Values option (V) of the Reset command (/R). You do not have to 
have the cursor in the Variable Sheet when you type the com- 
mand. Type: 

/R V 

Confirm the command by typing Y. 

Overdefining a Model 

Display the Rule Sheet in the top window and the Variable Sheet 
in the bottom. 

If you travel 100 miles at 60 mi/hr using 4 gallons of gasoline, 
what is your mileage for 5 hours? 
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Solving a Model 


On the Variable Sheet, enter these values in the Input fields for 
the variables: 



Input Value 

Variable Name 

100 

d 

4 

gas 

60 

s 

5 

t 


Solve the model by typing: 

! 

The screen should look like Figure 7-6. As you can see, although 
the program was able to find the value for mlg , something is 
wrong. The program produced error symbols in the Status fields 
for one of the rules and three of the variables, and the Solution 
Indicator is still on. 

( 5 i ) Input: 5 

==================== RU le SHEET ==================== 

S Rule 

m Lg = d/gas 
> s = d / 1 

* cost=gas*pr 


St Input Name 


VARIABLE SHEET 
Output Unit 


Comment 



m lg 

> 100 

d 

4 

gas 

> 60 

s 

> 5 

t 


cost 


pr 

Figure 7-6 



m i / g a L 
mi 
ga l 
mi / h 


h 

$ 

$ 


mi leage 
di stance 
amount of g 
speed 
t i me 

cost of t r i 
price of ga 
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Move the cursor to a variable Status field containing an error 
symbol. The error message is Overdefined, as it is for the other 
two. The input values are in conflict. 

One problem is in the second equation, as the Status field for that 
equation on the Rule Sheet indicates. Move the cursor into that 
Status field and look at the error message. It says that the rule is 
Inconsistent. All three of the variables in that equation have in- 
put values, and these values are not consistent with the relation- 
ship defined by the equation. 

To correct this error, one of the input values marked Overdefined 
should be blanked. Blank the value for t using either the Status 
field Blank option (B) or the Blank command (/B). 

Now solve the model. 

This time the model was solved, but the third equation is still un- 
satisfied because the model is now underdefined. To correct this, 
enter the input value 1.35 for the variable pr. 

Now solve the model again. This time it is completely solved. The 
screen should look like Figure 7-7. 

(7 i ) Input: 1.35 

==================== rule sheet ==================== 

S Rule 

m Lg = d/gas 
s=d/t 

cost=gas*pr 


==================== VARIABLE SHEET ================ 


Input 

Name 

Output 

Unit 

Comment 


m l g 

25 

mi /gal 

mi l e a g e 

100 

d 


m i 

di stance 

4 

gas 


ga l 

amount of g 

60 

s 


m i / h 

speed 


t 

1 .6666667 

h 

time 


cost 

5.4 

$ 

cost of tri 

1 .35 

pr 


$ 

price of ga 


Figure 7-7 
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If the model contains a math error, the TKISolver program shows 
error messages on the Prompt/Error line that can help you to 
find your mistakes and correct them. 

Changing the Model 

TKISolver models can be altered in a variety of ways and for 
many purposes. A simple model, such as travel, can be ex- 
tended by adding equations. Models can also be made more com- 
plex by modifying existing equations to account for factors 
previously unstated. 

Let’s modify the travel model to calculate the energy require- 
ments of a hypothetical car more accurately. Gas provides the en- 
ergy to move a car. The amount of energy (gas) is presently 
calculated based on distance (d) and an assumed gas mileage 
(mlg) value. It might be more accurate to calculate gas and gas 
mileage as a function of the energy inherent in the gasoline. This 
requires another equation in the model. 

The Insert Command 

Instead of adding the new equation to the bottom of the list of 
rules, we can choose to insert it at the top using the Insert com- 
mand (/I). This command inserts a blank row at the row contain- 
ing the cursor, moving everything at or below the cursor down 
one row. 

Move the cursor to the top of the Rule Sheet and type: 

/I 

A blank row is inserted at the top of the Rule Sheet. 

Enter the new rule with the variable power representing the en- 
ergy inherent in gasoline: 

gas = t *powe r 

The new variable power should be on the Variable Sheet. Give it 
the Calculation unit hp (horsepower) and the comment energy 
component. 

Move the cursor to the first blank row after the last equation on 
the Rule Sheet, and enter the equation shown below. It defines 


TKISolver Instruction Manual 


power as a function of mileage ( mlg ). Later in this chapter you 
will edit this equation to compute power based on drag consider- 
ations. 

d/(mlg*t)= power 

Because you have added a new rule that defines gas using the new 
concept of power, the value for gas will be derived when the 
model is solved. You must, therefore, blank the input value for 
gas on the Variable Sheet; otherwise the model is overdefined. 

When you have blanked the value for gas, solve the model with 
the value 225 hp for power and the values that are there from the 
last problem (d= 100, 5 = 60, pr= 1.35). The screen should look 
like Figure 7-8. 


( 8 i > Input: 225 

==================== rule sheet 

S Rule 

gas = t *powe r 
m lg=d/gas 
s = d / 1 

cos t=gas*pr 
d/ (mlg*t)=power 


VARIABLE SHEET 


I npu t 

Name 

Output 

Unit 

Comment 


mlg 

.26666667 

m i / g a l 

mi L e a g e 

100 

d 


m i 

d i stance 


gas 

375 

ga l 

amount of g 

60 

s 


m i / h 

speed 


t 

1 .6666667 

h 

time 


cost 

506.25 

$ 

cost of tri 

1 .35 

pr 


$ 

price of ga 

225 

power 


hp 

energy comp 


Figure 7-8 

As you can see, the model shows that at a speed of 60 mph you 
would get mileage of approximately .267 mi/gal. Change the 
speed to 100 and solve, then to 45 and solve. Obviously, the new 
concept of power requires a more refined equation than the cur- 
rent one. 
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SoSwimg a Model 

As the solutions above showed, the equation for power must be 
made more accurate. Increased accuracy is obtained by determin- 
ing drag characteristics, which are unique for every car. To in- 
crease the accuracy of the model, you can alter the equation to 
mimic the behavior of a hypothetical car. 

The Edit Field Command 

If you want to change an item in an entry field, you can use the 
Editor to do this. The Edit Field command (/E) calls the Editor 
to the field containing the cursor. 

Note: If you are editing a value, the Editor gives you access to 
the full accuracy of 12 digits. 

First, move the cursor to the field containing the rule 
d/(mlg*t)= power and call the Editor by typing: 

/E 

The message on the Prompt/Error line tells you that the Editor is 
in use: 

(Edit) 

The cue appears in the field, just as it appears when you are typ- 
ing information, but its behavior is slightly different when you 
are using the Editor. 

The Arrow keys, instead of entering what you have typed and 
moving the cursor, only move the cue. m and m move the cue one 
character to the right and left, t moves the cue to the beginning 
of the field, and * moves it to the end of the item. 

Move the cue around with the arrows and notice that it seems to 
create a blank space within the field. This blank space is actually 
not a space at all but marks a position between characters. If you 
type a character, it appears to the left of the cue. ◄ deletes the 
character to the left of the cue. 

The equation given below is a model for the power used by a hy- 
pothetical car driven at a given speed. It has been derived using 
two assumptions: 
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• The amount of internal friction, represented by the variable /, 
is constant. 

• Wind resistance, represented by the variable w, is a cubic func- 
tion of the speed of the car. 

With thought, an entire class of models could be built around this 
equation, expanding the travel model to deal with a wide vari- 
ety of situations. 

Use the Arrow keys and ◄ to edit the equation so that it looks like 
the one below. 

f + (w*s A 3) =power 
Enter the new equation with ♦ . 

Note: If you attempt to enter an equation that contains an er- 
ror, whether you are entering it for the first time or from the Edi- 
tor, there is an error signal, and an error message appears on the 
Prompt/Error line. The program calls the Editor and the cue is 
moved to the point where the error was detected so that it can be 
corrected. You will stay in the Editor until you either enter a valid 
rule or press 

Move the cursor into the Variable Sheet and down until the sheet 
scrolls up and you can see the two new variables that have been 
added. The values we will give these variables are hypothetical, 
but they could be obtained experimentally. 

Give / the Calculation unit hp and w the Calculation unit 
hp*h A 3/mi A 3. Comment / as internal friction and w as wind re- 
sistance. For this example, enter the input values of .75 for / and 
8.5E-6 for w. 

Note: The number entered in scientific notation is evaluated. 

Because you have edited the equation to determine power and en- 
tered values for the variables, blank the input value for power 
using the Blank option (B) in the Status field or the Blank com- 
mand (/B). 

Move the cursor to the top of the sheet so that you will be able to 
see the results when they appear, and solve the model. The screen 
should look like Figure 7-9. 
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( 1 i ) Input: 


RULE SHEET 

n 

ii 

ii 

ii 

ii 

ii 

ii 

n 

ii 

n 

ii 

u 

n 

ii 

ii 

ii 

ii 

n 

ii 

ii 

S Rule 

gas = t ★powe r 
m lg = d/gas 
s = d / 1 

cost=gas*pr 
f + (w*s A 3) =power 

VARIABLE SHEET == 


St Input 

Name 

Output 

Un i t 

Comment 


m Ig 

29.516665 

mi /gal 

mi leage 

100 

d 


mi 

distance 


gas 

3.3879167 

ga l 

amount of g 

45 

s 


mi / h 

speed 


t 

2.2222222 

h 

time 


cost 

4.5736875 

$ 

cost of tri 

1 .35 

pr 


$ 

price of ga 


power 

1 .5245625 

hp 

energy comp 


Figure 7-9 


If you try solving the model with different values for s, you will 
discover that the model now determines mileage much more ac- 
curately. The added equations made the model larger and im- 
proved its performance considerably. 

Save the new model using the filename TRAVEL2. You now have 
two versions of the travel model, the simple one in the file 
travel, and the more complex one in the file TRAVEL2. 

Note: 0 is the Edit command and is another way of calling the 
Editor. It can be used to modify existing field contents, just as the 
Edit Field command (/E) is, but you can use it anywhere, includ- 
ing on items that have not yet been entered. For example, 0 al- 
lows you to change a filename on the Prompt/Error line before it 
is entered. You will use 0 later in this manual. 

Conclusion 

This chapter has shown you how to enter values and how to solve 
and modify a model. The next chapter discusses units and the 
Unit Sheet. 
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Chapter 8 Units 

• Changing the Display unit 

• Conversion levels 

• The Move command (/M) 

• The Copy command (/C) 

• The Solve command (/!) 

• Saving the Unit Sheet 

• The Storage command (/S)— Save Units option (U) 

The TK! Solver program can convert values between units. In or- 
der to do these conversions, the program refers to the Unit Sheet 
on which conversions between specific units are defined. 

This chapter shows you how to set up the Unit Sheet so that it has 
the widest possible application within the program. 


To begin this chapter: 

At the end of Chapter 7, the Variable and Rule Sheets for 
TRAVEL2 were displayed. 

If you quit the program at the end of Chapter 7, load the 
TKISolver program, then load the file TRAVEL2. 

Display the Variable Sheet in a single window so that you can see 
the whole sheet. The screen should look like Figure 8-1. 

Changing the Display Unit 

When you entered the units on the Variable Sheet, you entered 
only one unit for each variable, so the unit that you see displayed 
for each variable is both the Display unit and the Calculation 
unit. If you want to check this, use the Dive command (>) to look 
at the Variable subsheet for each variable, and then return to the 
Variable Sheet with the Return command «). 

The unit conversions defined for this model are on the Unit 
Sheet. Use the Window command (/W) to display it in the bot- 
tom window. 

On the Variable Sheet, the unit for mlg is shown as mi/gal. On the 
Unit Sheet a conversion has been defined for mi/gal and km/1, so 
those units can be converted from one to the other. 
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( 1 i ) Input: 




= VARIABLE 

sheet ===== 


St Input 

Name 

Output 

Un i t 

Comment 


m l g 

29.516665 

mi / gal 

mi leage 

100 

d 


mi 

d i stance 


gas 

3.3879167 

ga l 

amount of g 

45 

s 


mi / h 

speed 


t 

2.2222222 

h 

time 


cost 

4.5736875 

$ 

cost of tri 

1 .35 

pr 


$ 

price of ga 


power 

1 .5245625 

hp 

energy comp 

.75 

f 


hp 

internal f r 

.0000085 

w 


hp* h A 3 / m i 

wind resist 


Figure 8-1 

Move the cursor into the Unit field for mlg on the Variable Sheet 
and type: 

km/ l ♦ 

The value for mlg is converted from mi/gal to km/1 according to 
the defined conversion. Now use the Dive command (>) to look at 
the subsheet for mlg . The Display unit has been changed to km/1, 
but the Calculation unit remains as mi/gal. 

Use the Return command (<) to display the Variable Sheet. Other 
units and values on the Variable Sheet can be changed according 
to conversions defined on the Unit Sheet. Change the unit for d 
from mi to km, for t from h to min, and for cost from $ to DM. 

If a unit conversion has not been defined on the Unit Sheet, the 
program cannot make the conversion, although it tries. If you 
enter a unit with no conversion defined on the Unit Sheet, a ques- 
tion mark appears beside the value, and the value displayed is in 
the Calculation unit. 

For example, there is no conversion defined between mi and ft. 
Change the Display unit for d to ft . The unit is changed when you 
enter it, but the value now has a question mark beside it. This tells 


TKISolver Instruction Manual 


you that the program could not make the conversion. The value 
displayed is the conversion to mi, the Calculation unit for d. 
Leave the unit as it is. This will be used later in an example. 

Conversion Levels 

The TKISolver program uses the Calculation unit as a base for 
conversions. It converts units directly and, to a limited extent, 
indirectly, using the conversions defined on the Unit Sheet. Some 
experimentation with the Unit Sheet will illustrate how this 
works. 

Move the cursor into the Unit Sheet and use the Window com- 
mand (/W) to display it in one window. In this example, you will 
define a set of linear units of measurement. So that you can more 
easily see what is happening in the example, you will enter this set 
of conversion definitions in a place on the sheet separate from 
those that are already there. 

The Move Command 

The Move command (/M) moves the row currently containing 
the cursor to a specified row, and changes the locations of the 
other rows appropriately. 

There is one direct conversion for linear measurement already on 
the sheet, the conversion from mi to km. Move the cursor to the 
row containing that conversion, then move the row to a new loca- 
tion on the Unit Sheet by typing: 

/M 

The prompt is: 

Move: Point to destination (1m): 

Use the cursor to point to the place you want the current row to 
be. The number and letter in parentheses changes according to 
the cursor position while the Position Indicator shows the origi- 
nal cursor position. As with the Blank (/B) and Delete (/D) com- 
mands, you can use the Goto command (:) to point to the 
destination. Type: 

: * ♦ 

Now complete the Move command by pressing $ . The screen 
should look like Figure 8-2. 
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(7m) Multiply By : 1 . 609 


UNIT SHEET 


From 

To 

Multiply By 

mi / h 

km/h 

1 .609 

mi /gal 

km/ l 

.4251 

ga l 

l 

3.785 

h 

m i n 

60 

C 

F 

1.8 

S 

DM 

.44 

m i 

km 

1 .609 


Add Offset 


32 


Figure 8-2 

Use the Insert command (/I) to insert a blank row between the 
row you just moved and the one above it. This will visually sepa- 
rate your new set of conversions from the existing set. 


Enter three more conversion definitions in the three rows below 
the one defining mi to km: 


From 

To 

Multiply By 

mi 

ft 

5280 

ft 

yd 

1 / 3 

yd 

i n 

36 


The screen should look like Figure 8-3. 

Notice that when you entered 1/3 in the Multiply By field, it was 
evaluated. The Multiply By column on the Unit Sheet can evalu- 
ate expressions, like the Input column on the Variable Sheet. 

Select ( = ) the Variable Sheet and notice that the value for d has 
been correctly converted to ft. Change the unit for d to mi again. 
The program can now correctly convert ft to mi and mi to ft. 
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(11m) Multiply By: 36 


From 

To 

Multiply By 

m i / h 

km/h 

1 .609 

mi /ga l 

km/ l 

.4251 

ga l 

l 

3.785 

h 

m i n 

60 

C 

F 

1 .8 

$ 

DM 

.44 

m i 

km 

1 .609 

mi 

ft 

5280 

ft 

yd 

.3333333333 

yd 

i n 

36 


Figure 8-3 

Change the unit for d to yd. Again the conversion is correctly 
made. Using the conversions defined on the Unit Sheet, the pro- 
gram can make the conversion from mi to ft and ft to yd. This is 
not a direct conversion from mi to yd, but an indirect conversion 
made through the unit ft in two steps. 

Now change the unit for d to in. As you can see by looking at the 
value for d , this time the program was unable to make the conver- 
sion. This indirect conversion required three steps to convert 
from the Calculation unit to the Display unit — mi to ft, ft to yd, 
then yd to in. The TK! Solver program can make indirect conver- 
sions through two steps and no more, and it was unable to make 
this conversion. 

To avoid problems of this sort, define all similar unit conversions 
either from a common unit or to a common unit. This prevents 
conversions that require more than two steps. 

For example, if all four of the conversions for linear units of mea- 
surement were either from mi or to ft, any one of the units could 
have been converted directly or indirectly to any of the others in 
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Omits 


no more than two steps. Then, if a new unit is added, such as m 
(meter), there is no confusion about which unit to use to define 
the conversion. 

Display the Unit Sheet in the window. Following the directions 
below, you will use ft as the common unit and set up a new set of 
conversions for linear measurements, adding a conversion for m 
(meters). 

First, use the Delete command (/D) to delete the conversions for 
mi to km and ft to yd. The conversions remaining are the ones for 
mi to ft and yd to in. 

There eventually will be five conversions in this set, for mi, yd, 
in, km, and m. All will be defined according to their conversion 
to ft. 

The Copy Command 

The To field will be the same for all the conversions you are about 
to define. Using the Copy command (/C) you can copy the item 
“ft” into the other five To fields you are going to use. The Copy 
command (/C) copies the item in the field currently containing 
the cursor to a specified field. 

Note: The Copy command (/C) is valid only on entry fields, 
but not on all entry fields. For example, you cannot copy a vari- 
able name in a Name field on the Variable Sheet to another field 
in that column because you cannot define two variables to have 
the same name. 

In this example, you will copy the To field item ft five times. 
Move the cursor to the To field containing the unit ft and type: 

/C 

The prompt is: 

Copy: Point to destination (8t) 

As with the Move (/M), Delete (/D), and Blank (/B) commands, 
you are asked to use the cursor to point to the location to which 
you want the field contents copied. The indicator in parentheses 
changes, as it did for the Move command (/M), showing the cur- 
rent cursor position. 
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Because the unit in the To field in the next row should be changed 
to ft, move the cursor down into the next To field and press ♦ . 
The new item ft replaced the old item in. 


Do this three more times to fill in the To field for the rest of the 
conversions: 


/Cl ♦ 


The screen should look like Figure 8-4. 


( 1 2 1 ) To: 

ft 





From 

To 

Multiply By 

m i / h 

km/h 

1.609 

m i / g a l 

km/ l 

. 4251 

ga l 

l 

3.785 

h 

m i n 

60 

C 

F 

1 .8 

$ 

DM 

.44 

m i 

ft 

5280 

yd 

ft 

36 


ft 



ft 



ft 



Add Offset 


32 



Figure 8-4 

Note: The Copy command (/C) can be used with the Switch 
command (;) to copy fields between windows. It can also be used 
with the Goto command (:). 

Finish entering the conversions to reflect Table 8-1. When you 
enter the expressions shown here, the program will evaluate 
them. 
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From 

To 

Multiply By 

mi 

ft 

5280 

yd 

ft 

3 

in 

ft 

1/12 

m 

ft 

1/.3048 

km 

ft 

1/. 3048 *1000 

Table 8-1 




Split the screen with the Window command (/W), and display the 
Variable Sheet in the bottom window. Change the unit for d to m, 
to yd, to km, to in. The program is able to make all of the conver- 
sions. 

Reset the values on the Variable sheet with the Variable Values 
option (V) of the Reset command (/R), so that you can enter the 
input values for a new problem. 

Note: Remember to check the Display unit before entering the 
value. Values are assumed to be in the Display unit, so you may 
need to change the Display unit before you enter the value. 

With internal friction of .5 Btu/s and wind resistance of .0000106 
hp*h A 3/mi A 3, what is your mileage if you travel 500 miles at 60 
miles per hour? 

The Unit Sheet contains no conversion for hp to Btu/s, so you 
must enter the conversion definition on the Unit Sheet before you 
enter the value for /. Move the cursor into the Unit Sheet and 
enter the conversion at the bottom: 

From To Multiply By 

hp Btu/s .706243 

Save TRAVEL2 again with the new unit conversions you have 
added. 

Now enter the new Display units for / and mi , and the values for 
all the input variables in the problem shown above. This time, 
instead of using the Action command (!) to solve the model, try 
the Solve command (/!). 
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The Solve Command 

The Solve command (/!) calls the solver to attempt solution of 
the model from any sheet. It does exactly what the Action com- 
mand does when the cursor is on the Variable or Rule Sheet, but 
the Solve command (/!) does it from anywhere in the program. 

If you wanted to solve the model now with the cursor on the Unit 
Sheet, you would find that the Action command (!) gives an error 
signal. Try it. Move the cursor into the Unit Sheet and type !. 

The Action command (!) performs a variety of actions depending 
on which sheet the cursor is in, but it solves the model only when 
the cursor is in either the Variable or Rule Sheet. 

Solve the model now by using the Solve command. Type: 

/ ! 

The model is solved; the screen should look like Figure 8-5. 


(13m) Multiply By: .706243 


UNIT SHEET 


From 

To 

Multiply By 

m i 

ft 

5280 

yd 

ft 

3 

i n 

ft 

.08333333333 

m 

ft 

3.280839895 

km 

ft 

3280.839895 

hp 

Bt u/s 

.706243 


ii 

n 

n 

n 

ii 

ii 

ii 

ii 

ii 

ii 

ii 

ii 

ii 

ii 

ii 

ii 

ii 

VARIABLE 

SHEET = = = == 


I npu t 

Name 

Output 

Unit 

Comment 


m lg 

8.5088876 

km/ l 

mi l e a g e 

500 

d 


m i 

d i stance 


gas 

24.979763 

ga l 

amount of g 

60 

s 


m i / h 

speed 


t 

500 

m i n 

time 


cost 


DM 

cost of tri 


pr 


$ 

price of ga 


power 

2.9975716 

hp 

energy comp 


Figure 8-5 

If your output values are significantly different from those 
shown, check that the units on the Variable Sheet are the same as 
those given in the problem. 


Chapter 8 

Units 


Note: The Solve command (/!) works on the Variable and Rule 
Sheets as well as all the others. 

Reset the program with the All option (A) of the Reset command 
(/R). 

Saving the Unit Sheet 

When you were building the model travel in Chapter 6, you 
loaded a file named TUNITS containing the Unit Sheet for the 
travel model. The Save Units option (U) of the Storage com- 
mand (/S) saves a file that contains only the information on the 
Unit Sheet. 

In this section you will create and save a file of unit conversions 
to be used in a later chapter for the example model mortgage. 

Creating the Unit Sheet 

Display the Unit Sheet in either window, and enter the three con- 
version definitions needed for the model MORTGAGE: 


From 

To 

Multiply By 

years 

months 

12 

percent 

monthly rate 

1/12*1/100 

percent 

decimal form 

.01 


As you can see, the names for these units are not the ones used 
with travel. The name of the unit is up to you, and it may con- 
tain blanks, as does monthly rate, underscores, as does 

decimal form, and any other printable characters. Blanks at the 

beginning and end of a unit name are deleted when the name is 
entered. 

You can define any unit according to any conversion you choose. 
The accuracy of the conversion is up to you, within the TK! Solver 
program limitation of 12 significant digits. 

The Storage Command — Save Units Option (U) 

The Save Units option (U) of the Storage command (/S) saves a 
file containing only the information on the Unit Sheet, ignoring 
all other information. The Unit Sheet does not have to be on the 
screen either to save or load the unit file. 
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Save a file of the Unit Sheet you have just created by typing: 

/SU 

At the prompt, enter the filename munits, for mortgage units. 
These units are now ready for the MORTGAGE model. 

Conclusion 

This chapter has discussed the Unit Sheet, how to set it up, and 
how it relates to the Variable Sheet. The next chapter discusses the 
Global Sheet and how to use your printer with the TKISolver pro- 
gram. 
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Chapter 9 Global Setting and Printing 

• The Global Sheet 

• The Printer fields 

• The Print command (/P) 

The Global Sheet is used for specifications that affect the model 
as a whole. The fields on the Global Sheet are divided into three 
sections, according to their use. This chapter describes the Global 
Sheet and how to use the group of fields on it that apply to your 
printer. 

Once you have set this group of fields to your requirements, you 
can use the Print command (/P) to print all or part of the con- 
tents of a sheet. You can use the Print command (/P) with a 
printer, or you can use it to write print files, files that are format- 
ted for printing. 

If you do not have a printer, you may want to read only the first 
section of this chapter, about the Global Sheet, and skip the rest. 


To begin this chapter: 

Use the Reset command (/R) to reset the program, and load the 
TRAVEL2 model. 

Display one window containing the Global Sheet by typing: 

/ W1 
= G 

The screen should look like Figure 9-1. 

The Global Sheet 

The fields on the Global Sheet are divided into three sections. The 
first contains only one field, the Variable Insert ON field dis- 
cussed in Chapter 6. The second section is a group of five fields 
concerning the Solvers. These fields and their use are discussed in 
Part III. The third group of fields is associated with the printer. 
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( v ) Variable Insert ON: Yes 

C U C C T — 

Variable Insert ON : 

ante 1 - 

Yes 

Intermediate Redisplay ON: 

Yes 

Automatic Iteration ON: 

Yes 

Comparison Tolerance: 

. 000001 

Typical Value: 

1 

Maximum Iteration Count: 

1 0 

Page Breaks ON: 

Yes 

Page Numbers ON: 

Yes 

Form Length: 

66 

Printed Page Length: 

60 

Printed Page Width: 

80 

Left Margin: 

0 

Printer Device or Filename: 

PRN 

Printer Setup String: 

Line End (CR/LF or CR): 

CR/LF 


Figure 9-1 

All of the fields on the Global Sheet have default values, but you 
can change any of them to suit the needs of your model and the 
requirements of your system. When you save your model, the 
Global Sheet is saved with any changes you have made. If you 
reset the Global Sheet with the Reset command (/R), the Global 
Sheet is reset with the default values. 

For example, change the first field to No by typing N in that 
field. Change the next two fields from Yes to No in the same way. 
Now type the Reset command (/R) using the Sheet option (S): 

/RS 

Type Y to confirm the command. 

Each of the three fields returns to Yes, the default value. 
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The Printer Fields 

The Print command (/P) either prints a specified portion of the 
current sheet on a printer or writes it in a print file on a diskette. 

If you do not have a printer, you may want to skip the rest of this 
chapter and go on to Part III. If you do not have a printer and 
would like to try the Print command (/P) anyway, you can use 
these instructions to create a print file and then look at the con- 
tents of the file by using the appropriate system command, 
shown in Chapter 2. 

If your system and your printer have constraints or requirements 
(such as the use of control characters to specify the printing for- 
mat) you must allow for them when using the printer with the 
TKISolver program. See the user manual for your printer to de- 
termine if there are constraints and what they are. 

Before trying out an example of the Print command (/P), you 
should look through the group of Printer fields on the Global 
Sheet to see that they are set up correctly for your printer and the 
paper you are using. 

Page Breaks ON 

The first field in the group of Printer fields is labeled Page Breaks 
ON and is an option field with the options of Yes or No. The 
default is Yes. 

If this field is Yes, the printer breaks the text at the bottom of a 
page of paper and starts again at the top of the next page, skip- 
ping one line at the top of the page and one at the bottom. This 
causes the printer to skip over the perforations in continuous feed 
paper. 

If this field is No, the printer prints continuous text with no 
breaks. The program assumes that form and page length are the 
same, and so ignores the next three fields. 

Page Number ON 

The Page Number ON field is another option field with the op- 
tions of Yes or No and has a default value of Yes. If this field is 
Yes, the page number is printed at the bottom of the page with 
one line space separating it from the preceding text. If the field is 
No, page numbers are not printed. If page breaks are not used, 
page numbers are not printed. 
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Form Length 

The Form Length field tells the program the length of the paper 
and is counted by lines. The default is 66 lines, the length of stan- 
dard letter size 8-1/2 x 11 paper. This field requires an integer. 

Printed Page Length 

The Printed Page Length field tells the program the length for the 
printed text, including the page number, if that option is used. 
The default is 60 which leaves six lines for top and bottom mar- 
gins on standard letter size 8-1/2 x 11 paper. These six lines are 
divided between top and bottom margin according to how you 
initially line up the paper in the printer. This field requires an inte- 
ger. 

Printed Page Width 

The Printed Page Width field tells the program the width of the 
printed text on the page and is counted by characters. The default 
is according to your system. Standard letter size 8-1/2x11 paper 
is 80 characters wide. This field requires an integer. 

Left Margin 

The Left Margin field tells the program the width of the left mar- 
gin counted by characters. The default is 0. The width of the right 
margin can be determined by adding this width to the printed 
page width and subtracting that number from the form width. 

For example, if your form is 80 characters wide, and you set the 
Printed Page Width to 65 and the Left Margin to 10, the right 
margin will be 5 characters wide. This field requires an integer. 

Printer Device or Filename 

The Printer Device or Filename field tells the program whether to 
print the text on the printer or in a print file. The default is the 
printer. 

The characters used to designate the printer are specific to your 
system and are the default for this field. 

If you are writing a file, enter the filename in this field, including 
any specifications necessary. Filenames must follow the rules for 
your system. The program automatically adds an extension to the 
filename, identifying the file as a print file. Refer to Chapter 2 
for the extension used for your system. 
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Printer Setup String 

The Printer Setup String field is specific to your printer. There is 
no default value because each printer has its own specifications, 
and you may not need a setup string at all. Look in the Hardware 
Reference or consult your printer manual to find the setup string 
for your printer. 

Characters that don’t print, such as the Escape character, are 
called control characters. They send special commands to the sys- 
tem. If your printer’s setup string requires control characters, a 
caret ( A ) tells the program that the next character represents a 
control character. Table 9-1 shows how to enter some of them. 
Refer to your printer manual for any others that you need. 

A C = The next character is a control character. 

A E = This is an escape character. 

A H = The next two characters are hex digits. 

AA = This character is a caret. 

Table 9-1 

If you enter characters that are not interpreted by your printer as 
control characters, the program will print them at the top of the 
page, but no spacial allowance is made for them in the Form 
Length and Printed Page Length settings. 

Line End 

The Line End field is specific to your system. Some systems re- 
quire different settings for a print file than for a printer. 

This is an option field. The default for this field is the same line 
termination as the one used by your system’s editor. If your sys- 
tem requires you to change the termination specifications for dif- 
ferent types of printing, the TKISolver program requires the 
same changes. Consult your system and printer manuals. 


The options are: 

Option: Type: 

Carriage Return & Line Feed & 

Carriage Return C 

Line Feed L 

System-defined S 


Note: If the default for your system is S, you cannot change the 
option. 
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The Print Command 

When you have checked all the print fields on the Global Sheet, 
you are ready to use the Print command (/P). 

The Print command (/P) either prints a specified portion of the 
current sheet on a printer or writes it in a file on a diskette, de- 
pending on what is specified in the Printer Device or Filename 
field on the Global Sheet. If it is copied in a file, the program 
gives the filename an extension that identifies it as a print file. 
The extension used for your system is given in Chapter 2. 

You must specify the block of text that you want to print. The 
Print Command prints the rows specified with the column labels. 

Connect your printer and turn it on. When you line up the paper, 
set it so that the print head rests on the line where you want the 
printing to begin. The printer prints one page length, according 
to the setting on the Global Sheet, then skips the number of lines 
that are the difference between the form length and page length. 
This gives you a margin at the bottom of the first page and top of 
the second; the lengths of the top and bottom margins depend on 
the difference between the form and page length and where you 
set the print head at the beginning. 

Suppose you want to print the first six variables on the Variable 
Sheet. Use the Select command ( = ) to display the Variable Sheet 
for TRAVEL2. Position the cursor on the first row that you want 
printed, in this example the first row on the sheet, and type: 

/P 

The prompt is: 

Print: Point to Last Line C 1 i ) 

The indicator in parentheses changes as you move the cursor, as it 
does for the Move (/M) and Copy (/C) commands. Move the cur- 
sor to the last row that you want printed. In this example use the 
Goto command (:) to point to row 6. Type: 

: 6 ♦ 

Now finish the Print command by pressing ♦ . As the printer 
prints the text, the screen shows you what is being printed. When 
it is finished, the previous display returns. 
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You can point to the portions of the sheet you want to print from 
bottom to top instead of top to bottom. The Print command (/P) 
always prints the rows from top to bottom, and always prints the 
column labels. 

To display the contents of a print file on your screen, see the in- 
structions for your system in Chapter 2. 

Conclusion 

This chapter has discussed the Global Sheet and shown you how 
to use the printer and the Print command (/P). This is the end of 
Part II. Part III explains the two methods of solution used by the 
TKISolver program to solve problems. 





Part III The Solvers 


The TK! Solver program uses two methods to solve problems, the 
Direct method and the Iterative method. The method you use de- 
pends on the problem you want to solve. Each solver uses the 
given input values to find all the variables possible within one so- 
lution of the problem. 

The TK! Solver program can solve most systems of algebraic 
equations, although its ability to do matrix and numerical tech- 
niques for integration is limited, and it cannot do non-numeric 
calculus. 

The program always attempts a solution using the Direct Solver 
first. If the problem is such that a Direct solution is not possible, 
you can set a guess value for one or more variables and use the 
Iterative Solver to attempt a solution. 

Throughout Part II you used the Direct Solver to solve the 
models travel and TRAVEL2, although how this method works 
was not explained. Part III discusses Direct and Iterative 
methods of solution, what each one is, and how they work. Chap- 
ter 12 also shows you how to use the Iterative Solver with the 
TK! Solver program and the conditions under which its use is nec- 
essary to solve a problem. 


Contents of Part III: 

• Chapter 10 The Direct Solver 

• Chapter 1 1 Iterative Solutions 

• Chapter 12 Using TK!Solver Iteration 
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Chapter 1 0 The Direct Solver 

• How the Direct Solver works 

• A single equation 

• A set of equations 

• The Direct Solver and the TKiSolver program 

• Changing an equation to avoid iteration 

• Models requiring iteration 

The Direct method of solution solves models by substituting 
known values to determine unknown values. This substitution 
enables the Direct Solver to solve for a variable regardless of its 
position in the equation. The Iterative Solver incorporates the Di- 
rect method of solution. 

This chapter is about the Direct Solver and how it works. 


To begin this chapter: 

Reset the program with the Reset command (/R). 

How the Direct Solver Works 

The Direct Solver solves a model containing several equations by 
the same method it solves a model containing a single equation. A 
model containing a single equation must meet the following con- 
ditions to be solved by the Direct method: 

1 All variables in the equation, except the one being solved for, 
must have input values. 

2 Because of internal contraints, the variable being solved for 
must appear only once in the equation. 

For example, the Direct Solver cannot solve for x in these equa- 
tions: 

x + x=y 

(Direct solution is possible if written as 2*X=y ) 

X*x = y 

(Direct solution is possible if written as X A 2=y) 

3 The variable being solved for cannot be the argument of a 
function without a unique inverse. 
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For example, the Direct Solver cannot solve for x in these equa- 
tions: 

int(jc) = y 
abs(x) = y 
sgn(x) = y 

A Single Equation 

Using these conditions, look at the equation: 
a + b = c 

Condition 2 has been met because none of the variables appears 
twice in the equation. And because the equation contains no 
function at all, condition 3 is not applicable. 

To meet condition 1, two of the three variables must be given in- 
put values. If, for example, the values of a and c are known, this 
model can be solved for the value of b. 

A Set of Equations 

For the Direct Solver to solve a set of equations, each equation in 
the set must meet the above conditions sometime during the solu- 
tion process. As each equation is satisfied, the output values are 
used as input values for other unsatisfied equations in the model. 

Example 1 is a model containing three equations. This model will 
be used to demonstrate how the Direct Solver works. Before en- 
tering this model on the TKISolver sheets, let’s examine how the 
Direct Solver would solve this model for two input values. 

Example 1 

a+b = c Equation 1 

d-e = b Equation 2 

d = {a 4 - b)/2 Equation 3 

If the value of a is 13 and of c is 4, then in: 

Equation 1, the values for a (13) and c (4) are known. 

Equation 2, no values are known. 

Equation 3, only the value for a (13) is known. 
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Equation 1 meets all three conditions for solution by the Direct 
Solver, so it can be solved for b (-9). 

When Equation 1 is solved and the value for b (-9) is known, 
Equation 3 meets the conditions for Direct solution, so it can be 
solved for d (2). 

When Equations 1 and 3 are solved, the values for b (-9) and d (2) 
are known. Then Equation 2 meets the conditions for Direct solu- 
tion and can be solved for e (1 1). 

The model can be completely solved by the Direct Solver if input 
values are given for a and c. 

The Direct Solver and the TKiSolver Program 

Now try Example 1 using the TKiSolver program. Enter the three 
equations on the Rule Sheet, and then enter the value 1 3 for a and 
4 for c. 

While the model is being solved, notice the message on the 
Prompt/Error line that tells you the Direct Solver is working. 
Solve the model by typing the Action command (!) or the Solve 
command (/!). The screen should look like Figure 10-1. 

( 3 i ) Input: 4 

= = = = = = = = = = = = = = = :=r = r:= VARIABLE SHEET = = = = = = = = = = = = = = = = 

St Input Name Output Unit Comment 

13 a 

b 

4 c 

d 


-9 

2 

1 1 


S Rule 


RULE SHEET 


a + b = c 
d-e = b 
d = (a+b) /2 


Figure 10-1 
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What would the Direct Solver do if one of the equations failed to 
meet the conditions for Direct solution? To try this, edit Equation 
3 so that it looks like this: 

d=(a+b) / (2*d) 

Solve the model. 

The asterisks in the Status fields for Equations 2 and 3 tell you 
that these equations are unsatisfied. The Direct Solver solved 
Equation 1 , but neither Equation 2 or 3 satisfied the three condi- 
tions necessary for Direct solving. Equation 3 could not be solved 
because the unknown variable d occurs twice, violating the sec- 
ond condition for Direct solution, and Equation 2 failed because 
it contained two variables without known values, violating the 
first condition. 

Use the Reset command (/R) to reset the values for this model, 
then save it in a file named DTWO. It will be used as an example in 
Chapter 12. 

Changing an Equation to Avoid Iteration 

Equations that cannot be solved by the Direct method of solution 
can often be solved using the Iterative method, but the need for 
iteration can frequently be avoided if you rewrite the equations so 
that they meet the three conditions. There are many ways to re- 
formulate models. 

For example, in this problem you can rewrite Equation 3 so that 
the Direct Solver can solve the model for some sets of known 
values. 

One way to rewrite the equation is to use the built-in square root 
function. This function has the syntax: 

SQRT(x) 

The equation below shows the same relationship between the 
variables as Equation 3, but because it uses the variable d only 
once, it meets the second condition for Direct solution, the condi- 
tions that it previously violated. Edit Equation 3 so that it looks 
like this: 


d = S Q R T ( ( a + b ) 12) 
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Note: Names of the built-in functions can be typed in either up- 
percase or lowercase characters, or a combination. 

Note: The TKiSolver program always returns a positive square 
root, so the third condition, requiring a function to have an in- 
verse, has also been met. 

Give a a value of 13 and c a value of 4 and solve the model. The 
screen should look like Figure 10-2. 


C 3 i > Input: 4 


St Input 
13 
4 


Name 

a 

b 

c 

d 

e 


VARIABLE SHEET ============= 

Output Unit Comment 


1 .4142136 
10.414214 


S Rule 


RULE SHEET 


a + b = c 
d-e = b 

d=SQRT((a+b)/2) 


Figure 10-2 

Another way to change an equation is to use a factored form. For 
example, if the original equation is in this form: 

d+b*d=a 

it could be changed to: 
d*( 1 + b) = a 

The equation now contains the variable d only once. 

Other techniques for reformulating models are discussed in 
Chapter 12. 
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Models Requiring Iteration 

In any model, the Direct Solver solves all equations that meet the 
three conditions for Direct solution. The modified version of Ex- 
ample 1 is a model that cannot be completely solved using the 
Direct Solver. If the model contains an equation that cannot be 
solved by the Direct Solver, the asterisk remains in the Status field 
of that equation after the Direct Solver has stopped. 

Below are three examples of models that require Iterative solu- 
tions. Each example lists the known (input) and unknown (out- 
put) variables and the reason the model requires iteration. 

Example 2: 

-8 = 3*a-2*b + c-d+ 4*e 

-27 = 2*a-b-c+ 3*d+ 5*e 

1 5 = a + b T c-2*d-2*e 

-2 = 3 + 3*b-c-d + 2*e 

1 3 = a + 2*6 + c-4*d+ 3*e 

Known Variables: None 

Unknown Variables: All variables 

Need for Iteration: Not enough input values. 

(Example 2 is used again in Chapter 12 and is stored in the In- 
struction File LINEAR.) 

Example 3: 

y = x A 2-2*x-5 
Known Variables: y 
Unknown Variables: Jt 

Need for Iteration: Variable being solved for occurs more than 


once. 
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Example 4: 

b = log(a) A 2-Iog(a) 
cr = sin(b) A 3 

Known Variables: None 
Unknown Variables: All variables 

Need for Iteration: Not enough input values and variable being 
solved for occurs more than once. 

Conclusion 

This chapter has shown you how the Direct Solver works. The 
next chapter discusses the concept of iteration. If you are familiar 
with this concept you may want to go on to Chapter 12. 
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Chapter 1 1 Iterative Solutions 

• The concept of iteration 

• The divide and average method 

• The first guess 

• Watching iteration work 

As was shown in the last chapter, some equations cannot be 
solved using the Direct method of solution. Often these equations 
can be solved using an Iterative method of solution. The 
TKISolver program has an Iterative Solver that can be used to 
attempt a solution when the Direct Solver is unable to solve the 
model. To use the Iterative Solver to its best advantage, you 
should first understand what an Iterative solution is. 

This chapter is about the concept of iteration and how it can be 
used to solve problems. If you know what iteration is, you may 
want to skip this chapter and go on to Chapter 1 2, which explains 
how to use the program’s Iterative Solver. 


To begin this chapter: 

Reset the program using the Reset command (/R). 

The Concept of Iteration 

Iteration is a problem solving procedure that uses successive ap- 
proximations to find an answer. The procedure repeats a set of 
operations, each repetition more closely approximating the an- 
swer. 

You have probably used an Iterative method before, but never 
called it by that name. The game of Twenty Questions follows an 
Iterative procedure. You begin with a guess, and each guess gains 
you some information that improves the next guess. Eventually 
this guessing leads you to narrow in or converge on an answer. All 
Iterative methods, no matter how they are defined, follow this 
same procedure. 

In mathematics, the first step in an Iterative procedure is to guess 
the answer to the problem. By manipulating this guess, a new 
guess is generated that more closely approximates the answer. 
This process is repeated until a solution is reached. 
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There are many different methods of mathematical iteration, and 
they differ primarily in the way the guess is manipulated to find 
the next approximation of the answer. Some methods are more 
generally applicable while others have only restricted use. The 
method used by the TKiSolver program is widely applicable. 

The process of making a guess, manipulating it mathematically, 
and generating a new guess constitutes one step or iteration. The 
number of steps needed to solve a problem varies greatly, and de- 
pends on the particular Iterative method being used and on how 
close the first guess is to the correct answer. Sometimes, no mat- 
ter how many steps are executed, an Iterative process does not 
converge to a solution. 

The procedure may be unable to converge to an answer for one of 
several reasons. The most common reasons are that the system of 
equations does not contain a solution that satisfies all the equa- 
tions simultaneously or that the first guess was poor. 

The Divide and Average Method 

The following example illustrates one Iterative method and 
shows how iteration works, each step moving closer to the an- 
swer. This particular Iterative method, known as the Divide and 
Average method, was developed by Heron of Alexandria in the 
first century A.D. It is used to determine square roots. 

Each iteration of the Divide and Average method is composed of 
these operations: 

1 Guess a value for the square root of a number n. 

2 Divide the number n by the guess. 

3 Find the average of the guess and the quotient calculated in the 
second step. 

4 Use this average as a new guess. 

5 Repeat the process until the average converges to an answer. 

Using these four steps of the Divide and Average method, you can 
determine a square root by working through several iterations. 
To do this with pencil and paper requires much cumbersome long 
division. Instead, let’s set up the problem as a TKiSolver model. 
Then you can see how iteration works using the Divide and Aver- 
age method, without doing any of the calculations yourself. 
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Step 1 is to choose the first guess, and you must do this yourself. 
But the model you are about to build will do the rest of the prob- 
lem for you. 

In step 2 you divide the number you are trying to find the square 
root of by your guess. In the equation below, n represents the 
number, g the guess, and q the quotient, the result of step 2. Enter 
this equation on the Rule Sheet: 

n/g = q 

In step 3 you find the new guess, ng , by averaging g and q. On the 
Rule Sheet, enter the equation for step 3. 

ng=(g + q) 12 

The screen should look like Figure 11-1. 

(2r) Rule: ng=(g+q ) / 2 

==================== VARIABLE SHEET ================ 

St Input Name Output Unit Comment 


n 

9 

q 

ng 


==================== rule SHEET 

S Rule 

★ n/g=q 

★ ng=(g+q)/2 


Figure 11-1 

The First Guess 

The problem is to find the square root of 1296. First, decide on a 
first guess. 
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If you know the square root of a number less than 1296 and one 
greater than 1296, a good guess might be a value between those 
two. The square roots of 900 and 1600 are 30 and 40, respectively. 
Then, since 


900 

< 

1296 

< 

1600 

V 900 

< 

/T296 

< 

•J 1600 

30 

< 

V 1296 

< 

40 


The square root of 1296 is between 30 and 40. Because 35 is mid- 
way between these two known square roots, it is a good value for 
the first guess. 

The model needs two input values, the value of the first guess and 
the number whose square root you are trying to find. On the Vari- 
able Sheet, enter 1296 as the input value for n and 35 as the input 
value for g. 

The model has been set up so that each solution creates a new 
value for ng , which is then used as the value for g in the next itera- 
tion. 

Watching Iteration Work 

With the cursor in the Input field for g, follow the instructions 


below: 


Type: 

Result: 

! 

Solves the model with <7 = 37.028571 and 
ng = 36.014286. 

ng ♦ ! 

Enters ng as the new guess and solves with 
q = 35 .985720 and ng = 36.000003 . 

ng ♦ ! 

Enters ng as the new guess and solves with 
q = 35. 999997 and ng = 36. 

ng ♦ ! 

Solves the model. All values are now 36. The 
square root of 1296 is 36. 
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As you can see in Table 1 1-1, the consecutive values for ng de- 
crease towards 36. 

ng 

36.014286 

36.000003 

36 

Table 11-1 

This method, like most Iterative methods, converges on the an- 
swer. The TK! Solver program’s Iterative Solver is much more 
powerful and easier to use than the Divide and Average method. 
The principle is the same, but the Iterative Solver uses more so- 
phisticated methods, and the TK! Solver program does the work. 

Conclusion 

This chapter has explained the concept of the Iterative solution. 
The next chapter explains how the Iterative Solver works and 
how the TK! Solver program uses iteration. 
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Chapter 12 Using TKiSolver Iteration 

• Using iteration in the TKiSolver program 

• Unsuccessful guesses 

• Slow convergence 

• Divergence and oscillation 

• Changing the number of iterations 

• Comparison tolerance 

• Input values 

• Redundant equations 

• Automatic iteration 

One of the Solvers used by the TKiSolver program is the Iterative 
Solver. When you have a problem that requires an Iterative solu- 
tion, you can set one or more values as a guess and use the Itera- 
tive Solver to solve the model. 

This chapter shows you how to use the Iterative Solver and ex- 
plains how it works. 


To begin this chapter: 

Reset the program and load the model named dtwo, saved on the 
Instruction diskette in Chapter 10. The screen should look like 
Figure 12-1. 

Using Iteration in the TKiSolver Program 

To use the program’s Iterative Solver, all you have to do is set a 
first guess for the desired variable, and type the Solve command 
(/!). The better your first guess, the more quickly the Iterative 
Solver can solve the model. The DTWO model that you created in 
Chapter 10 is used here to show you what the program looks like 
when you use the Iterative Solver. 

This model requires iteration because the variable d appears twice 
in the third equation. Because it appears twice, tfis the value that 
must be found by iteration. 

Give a the value 13 and c the value 4. Use the value 12 for your 
first guess for d. Enter 12 in the Input field, then set it as a guess 
by moving the cursor to the Status field for the variable d and 
typing the Status field option: 




Chapter 12 
Using TKISolver Iteration 


(3 r ) Rule: d= < a+b) / < 2 *d) 

==================== VARIABLE SHEET ============ 

St Input Name Output Unit Comment 


a 

b 

c 

d 

e 


S Rule 

★ a + b = c 

★ d-e=b 

★ d= ( a+b) / (2*d) 


RULE SHEET 


Figure 12-1 

This is one of the Status field options discussed in Chapter 6. It 
sets the variable as a guess variable, and the input value you give 
that variable is used as the first guess. Notice that on the Status 
line the content of the Status field is spelled out as Guess. You can 
remove the Guess setting by typing the Guess option (G) again. 

Note: If you do not enter a value in the Input field before you 
type the Guess option (G) in the Status field, the program will 
automatically put into the Input field either the last value for that 
variable or, if there was no previous value, a 0. 

With 12 set as a first guess for d , solve the model by typing the 
Action command (!) or the Solve command (/!). 

Note: The message that appears at the top of the screen during 
Iterative solution is explained later in this chapter. 

The screen should look like Figure 12-2. 
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(4s ) Status: 


St Input Name 


13 a 

b 

4 c 

d 
e 


S Rule 

a + b = c 
d~e = b 

d= (a+b) / (2*d) 


VARIABLE SHEET ================ 

Output Unit Comment 


-9 

1 .4142136 
10.414214 


RULE SHEET 


Figure 12-2 


The BOX Model 

Although iteration is easy to use, you must know more about the 
Iterative Solver and its method of solution before you can use it 
to the best advantage. The following example illustrates both the 
use of the Iterative Solver and the concepts behind its use. 

The Problem 

A company produces rectangular boxes and wants to know on 
what basis to price them. The price can be based on either the 
surface area or the volume of the boxes. The values representing 
both the surface areas and the volumes are dependent on the 
length, width, and height of the boxes. 

To choose the attribute on which to base box prices, you must 
first determine the dimensions of the box for which the values for 
the volume and surface area are equal. The range of box sizes the 
company produces based on volume is between 1 and 10. If vol- 
ume increases more rapidly than surface area, the price of the 
boxes might be based on volume, and vice versa. 

The model you are about to enter is named box and can solve this 
problem using the Iterative Solver. 
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Reset the program and enter Equation 1, the equation for vol- 
ume, on the Rule Sheet. The volume of the box is represented by 
K the length by /, the width by w, and the height by h. 

V= L *w*h Equation 1 

The two equations below are equivalent equations for surface 
area. The variable SA represents surface area. 


S A - 2 ★ l ★ w + 2 * l * h + 2 ★ w ★ h 

SA = 2* ( l*w+l*h + w*h) 


Equation 2 


Equation 2 is shown in two forms. The second one is the factored 
form of the first. Using factored forms of equations often re- 
duces the processing time needed by the TK! Solver program. 

Enter Equation 2 in the factored form (the second form) on the 
Rule Sheet. 

To solve this problem for all rectangular boxes would involve the 
investigation of many different possibilities. We are using this 
model as an example of iteration, so we will consider only the 
special case of cubes for which all three dimensions are equal. 

Since the problem is to determine when a cube’s volume and sur- 
face area are equal, you need three more equations to complete 
your model. 

Equation 3 sets the length and width equal, and Equation 4 sets 
the width and height equal. These equations restrict the model to 
cubes. Equation 5 sets the volume and surface area equal. Enter 
Equations 3 through 5 on the Rule Sheet. 

l = w Equation 3 

w = h Equation 4 

V = S A Equation 5 

The box model is now complete. The screen should look like Fig- 
ure 12-3. 
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(5 r ) Rule: V = S A 

St Input Name Output Unit Comment 


V 

L 

w 

h 

SA 


= = = = = = = = = = = = = = = =:=: = = = RULE SHEET = = = = = = = = = = = = = = = = = = = = 

S Rule 

★ V=l*w*h 

★ S A = 2 ★ ( (.★w+l*h + w*h) 

★ l=w 

★ w = h 

★ V = S A 

Figure 12-3 

Enter the value 10 for / and solve the model. 

The program solves the model, but there is a > in the Status fields 
for V,SA, and the equation V=SA. Move the cursor to the Status 
field for V=SA and look at the message on the Prompt/Error 
line: 

(5s)Status: > Inconsistent 

The message tells you that the equation is inconsistent with the 
given values. The model is overdefined and was solved with dif- 
ferent values for Kand SA . They are not equal although the equa- 
tion says they should be. 

Often such an inconsistency can be overcome by setting one of 
the inconsistent variables as a guess and solving the problem 
iteratively. When a variable is designated as a guess, the program 
uses the Iterative Solver to solve a model. A variable is designated 
as a guess when the G appears in the Status field of the variable. 

Since you have already entered 10 as a value for /, use it as your 
guess. In the Status field for the variable /, type: 

G 


12-5 
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The model is now ready for the program to attempt an Iterative 
solution. As the Iterative Solver works, a message on the 
Prompt/Error line will show the number of iterative steps that 
have been tried out of the approximate number of iterative steps 
needed to solve the problem. The estimate of the total number of 
iterative steps needed may change during the iteration process. 

When the Solver has finished, both the G and the message will 
disappear, and the value for / will be moved to the Output field. 

In this problem, the answer will converge to 6 after seven steps of 
iteration. Table 12-1 illustrates what will happen when you solve 
the model with a guess of 10 for /. 

Step Value 


1 

2 

3 

4 

5 

6 
7 


10 


7.7778074 

6.5577657 

6.0810962 

6.0021081 

6.0000015 

6 


Table 12-1 

Now solve the model and watch the values for / change as in Table 


12 - 1 . 


The model was solved iteratively showing you that cubic boxes of 
6 units to a side have equal surface area and volume. 

Because this example has been built primarily to demonstrate 
iteration in the TKISolver program, there is no further analysis 
of the box model in this manual. However, the BOX model will be 
used later in this chapter. Save the model using the filename BOX. 

Unsuccessful Guesses 

When using iteration, you should give some thought to the guess 
you use because results can vary significantly depending upon the 
nature of the guess. 

In problems that have multiple solutions, the Iterative Solver can 
find only one of the solutions for a given first guess. To find the 
other solutions to the problem, you must try different first 
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guesses. One method for doing this is to edit the equation so that 
both sides are divided by (x-r), with * representing the variable 
and r representing the answer found by the first guess value. 

Although there is no assured method of avoiding an unsuccessful 
guess, the more reasonable the guess is, the more likely you are to 
get the desired results. 

Every guess leads either to a solution of the model or to one of 
three less satisfactory results. The three unsuccessful results are: 

• A slow convergence. 

• Iterations that diverge, moving away from the correct answer 
instead of towards it. 

• Iterations that oscillate between two values. 


Slow Convergence 

The BOX model can be used to demonstrate the first type of un- 
successful result, a slow convergence. Any number could have 
been used as a guess for the value of / in the box model, and an- 
other number might not have been as successful a guess. 

For example, try to solve the model using a first guess of 4 for /. 
You do not have to reset the values left from the previous solu- 
tion. Change the value of / to 4, and type a G in the Status field. 
While the model solves, compare the successive output values 
with Table 12-2, which shows the values of / for each step of itera- 
tion. 


Step 

Value 

Step 

Value 

1 

4 

6 

10.716623 

2 

44 

7 

8.2081384 

3 

30.066811 

8 

6.7724745 

4 

20.813598 

9 

6.1434953 

5 

14.701069 

10 

6.0064065 

Table 12-2 



Solve the model. 




When the Iterative Solver finishes, the screen should look like 
Figure 12-4. 
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( 2 i ) Input: 6.0000137581 

==================== VARIABLE SHEET ============ 

St Input Name Output Unit Comment 


V 

G 6.0000138 l 
w 
h 

SA 


=== RULE SHEET =================== 


S Rule 


* V= l * w*h 

* SA=2*(l*w+l*h+w*h) 

* t = w 

* w = h 

* V = S A 


Figure 12-4 


The value of / is still in the Input field, and the G is still in the 
Status field. The message for the Iterative Solver told you that 
there were 10 steps of iteration tried. After doing 10 iterative 
steps, the Iterative Solver stopped, although the values were con- 
verging correctly towards 6. The guess of 4 resulted in a slow con- 
vergence. 

When a model fails to converge, you can type the Solve command 
(/!) again to restart the solving process. Solve the model again. 
This time the model is solved in one more iteration. 


Divergence and Oscillation 

The other two types of unsuccessful guesses are easy to identify 
from their results. As an example, reset the program, and enter 
this equation: 

-2 ★ x A 2+3 ★ x -2 = y 

Give y a value of 0. Give x the value of 2 and set it as your first 
guess. 

Solve the model and watch the values for x. 
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The successive values for x follow no clear pattern and the mes- 
sage on the Prompt/Error line shows high approximations for 
successful iteration. Whenever the estimate for the total number 
of iterations needed is consistently over 20 within one solving, it 
is possible that your first guess will not be successful. 

It is possible that the first guess will never lead to a solution. If 
this is the problem, you should try a different guess and attempt 
to solve the model again. Try a new guess of .22 and solve the 
model again. 

This model still fails to solve, because there is something wrong 
with the model. It could be one of two things, either the equations 
are inconsistent or the solution is not a real number. 

In this case, the solution set consists of complex numbers. This 
version of the TKISolver program does not perform complex 
arithmetic. 

Changing the Number of Iterations 

Reset the program and load the BOX model again. When you 
solved the BOX model earlier, it required more than 10 iterations 
to solve from the first guess of 4 after the Iterative Solver was 
restarted. 

The default for the maximum number of iterations is 10, but the 
Iterative Solver stops before that if it converges to an answer. The 
maximum number of iterations is set on the Global Sheet. 

Change the screen to one window and display the Global Sheet. 
There are five fields in the second group of fields on the sheet. 
The settings for these fields control the global defaults for the 
Solvers. 

The last field in the group of Solver fields is the Maximum Itera- 
tion Count field. It sets the maximum number of iterations per- 
formed by the Iterative Solver. Currently it is set to 10, the 
default count. You can set it to any number you choose, but it 
must be an integer. 

Earlier, you ran the Iterative Solver twice to solve the BOX model 
from a first guess of 4. If the Maximum Iteration Count had been 
20 instead of 10, the Iterative Solver would have had to run only 


once. 
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Move the cursor to this field and enter the value 20. Later you 
will solve the box model again using this setting. 

When you were running the Iterative Solver, the intermediate 
values for each step of the iteration were displayed on the sheet. 
The first field in the group of Solver fields, labeled Intermediate 
Redisplay ON, controls this intermediate display. Since you have 
solved the BOX model several times already, the intermediate 
values will not be interesting for another solving, so change the 
value here to No by typing N. 

Changing this field to No can speed up the time needed to solve a 
model. If you type Y, the value changes back to the default value 
of Yes, but leave the field at No for this example. Now when the 
model is solved, the Solver message will still change to show the 
iterations, but the intermediate values will not be displayed. 

Display the Variable Sheet and solve the box model with a first 
guess of 4 for /. Although the intermediate values are not dis- 
played, each iteration step is noted on the Prompt/Error line as 
the model is solved. When the Iterative Solver finishes, the Solu- 
tion Indicator disappears. 

Comparison Tolerance 

How does the program know when the Iterative Solver has 
reached a solution? The first solution of the BOX model, using 10 
as a guess, required only seven iterations, although the number of 
iterations was set at 10. While the program solves the model, it 
checks both values and equations to see if they are equal accord- 
ing to the Comparison Tolerance specified on the Global Sheet. 

Display the Global Sheet again. The third field in the group of 
Solver fields is the Comparison Tolerance field. The default value 
is 0.000001. 

As the Iterative Solver works, it compares each successive guess 
value with the current guess value. If the absolute value of their 
difference divided by the absolute value of the larger of the two 
values is greater than the Comparison Tolerance, a new guess is 
generated. If the ratio is less than or equal to the Comparison 
Tolerance, and if each set of expressions in each equation and all 
values of a variable are judged equal by the Comparison Toler- 
ance, the problem is considered solved. 
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This concept for guess values can be stated algebraically. Letting 
ng stand for new guess, pg for previous guess, and CT for Com- 
parison Tolerance, the Iterative Solver stops whenever the in- 
equality below is true: 

I P8 - ng I < rr 

max (\ng\, \pg\) 

Table 12-3 shows the values for this inequality for each iteration 
of the BOX model when it was solved with a first guess of 10. 


Ipgl 

|ng| 

lpg-ng| 

max(|ng|,|pg|) 

7.7778074 

6.5577657 

.15686191 

6.5577657 

6.0810962 

.07268779 

6.0810962 

6.0021081 

.01298912 

6.0021081 

6.0000015 

.00035098 

6.0000015 

6.0000000 

.00000025 

Table 12-3 




The Iterative Solver stopped when the inequality obtained a value 
less than the Comparison Tolerance default value: 

.00000025 < .000001 

As the Comparison Tolerance increases in value, the precision of 
the solution decreases. Conversely, as the Comparison Tolerance 
is made smaller, the solution becomes more precise. 

Note: The Comparison Tolerance also has an influence on the 
Direct Solver. The Direct Solver uses the Comparison Tolerance 
to determine equality. If the ratio of the absolute value of the dif- 
ference between two expressions to the expression having the 
greater value is less than the Comparison Tolerance, the values 
are treated as equal by the Direct Solver. 

Input Values 

The number of input values required for a model varies with both 
the required output and the method of solution. The number of 
input values needed for the Direct solution of a model can be 
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found from the following equation. The variable V represents the 
number of variables, E the number of equations, and NV the 
number of input values needed to solve the model. 

V-E = NV 

Reset the program and load the dtwo model again. This example 
uses the dtwo model to experiment with the relationship ex- 
pressed by the equation above. 

In the dtwo model there are 5 variables and 3 equations. In the 
equation above, if V is 5 and E is 3, then NV is 2. You need two 
input values to solve the dtwo model. 

Try solving the dtwo model giving input values to different pairs 
of variables. 

There are ten possible pairs of variables for input, but only four 
of these pairs result in a complete solution of the model. The rela- 
tionship expressed in the equation above tells you only hovtf many 
input values are needed for solution, not which variables must 
have the values. 

Input values for the following variable pairs provide solutions to 
the model: 

a, d 

b, d 
b,e 
d,e 

All other solutions of the model require iteration and, therefore, 
at least one input guess value as well as the two regular input 
values are needed. 

Let’s use a specific example. Reset the variable values, then enter 
the values 1 3 for a and 4 for c. 

When you solved this model at the beginning of the chapter, you 
set the guess values for d because it appears more than once in the 
third equation and is the variable necessitating the iterative solu- 
tion. A guess value is really an output value rather than an input 
value, so you must still set a guess for d. 
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Set d as the guess variable again by typing G in the Status field. If 
you have not yet entered a value, the program automatically gives 
d the value 0 when it is set as a guess. Enter a guess value of 6 in 
the Input field for d and solve the model. 

The screen should look like Figure 12-5. 


(4 i ) I npu t : 

==================== VARIABLE SHEET ============ 

St Input Name Output Unit Comment 


13 a 

b -9 

4 c 

d 1.4142136 

e 10.414214 


S Rule 

a + b = c 
d-e = b 

d= (a+b) / (2*d) 


RULE SHEET 


Figure 12-5 


Redundant Equations 

An Iterative solution can be avoided in many models by adding a 
redundant equation to the model. A redundant equation is deter- 
mined by an algebraic manipulation of one or more equations of 
the model. 

An algebraic manipulation of the third equation of the dtwo 
model yields a very useful redundant equation. By multiplying 
each side of the equation by 2 *d, the equation is transformed to: 

2 *d A 2 = (a + b) 

By substituting for c from the first equation, the result is: 

2 *d^2 = c 
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Add this equation to the Rule Sheet. To blank the old output 
values, use the Blank option (B) in the Status fields for the vari- 
ables b, d , and e; then solve the model with the current input 
values of 13 for a and 4 for c. 

The screen should look like Figure 12-6. 


(5s) Status : 

==================== VARIABLE SHEET 

St Input Name Output Unit 

13 a 

b -9 

4 c 

d 1.4142136 

e 10.414214 


Comment 


S Rule 


a + b = c 
d-e = b 

d= ( a + b) / ( 2 *d ) 
2*d A 2=c 


RULE SHEET 


Figure 12-6 


Notice that the solution is the same as the last one, which was 
solved by iteration. This redundant equation allows the Direct 
Solver to solve the model for all pairs of input variables except 
a,e and c,d. 

If your model contains redundant equations, the number of vari- 
ables requiring input values is determined by the equation below 
in which NV represents the number of variables needing input 
values, Kis the total number of variables, TE is the total number 
of equations, and RE is the number of redundant equations. 

NV= V-TE + RE 

Note: In any system of equations, some equations may be unin- 
tentionally redundant. 
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Automatic Iteration 

You can use the Iterative Solver without setting a guess on the 
Variable Sheet by setting the program to use Automatic Iteration. 
If the variables are set for Automatic Iteration, the program au- 
tomatically uses the Iterative Solver if the Direct Solver fails to 
solve the model. The fields that you must set to do this are on the 
Global Sheet and the Variable subsheets. 

Display the Global Sheet in the top window. 

The second field in the group of Solver fields is the Automatic 
Iteration ON field. The default value for this field is Yes. If the 
field is set to Yes, the Direct Solver automatically calls the Itera- 
tive Solver if: 

1 The Iterative Solver is needed to solve the model, 

and 

2 The variables that require Iterative solutions have values in the 
First Guess fields on their Variable subsheets to set default first 
guesses. 

The model you will use to demonstrate the Automatic Iteration 
feature is the simultaneous linear equation model that you saw in 
Chapter 10. It is in an Instruction File named linear. 

Reset the program and load the file linear. 

Display the Global Sheet in the bottom window and check it to 
see if the Automatic Iteration ON field is set to Yes. If it is not, 
type Y in that field, then return to the Rule Sheet. 

To use Automatic Iteration, you must enter the first guess for 
each variable on its Variable subsheet. Move the cursor to the row 
for the variable a and use the Dive command (>) to display the 
Variable subsheet for a. 

The First Guess field is the second field on the sheet. Enter the 
value 1 in this field. This value will be the default first guess value 
for a if the Iterative Solver is used. 

Return to the Variable Sheet, dive into the Variable subsheets for 
each of the other variables, and enter 1 in the First Guess field on 
each subsheet. The linear model is now set to perform Auto- 
matic Iteration. 
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The message on the Prompt/Error line will be first the Direct 
Solver message, and then, when the Direct Solver is unable to 
solve the model, the Iterative Solver message. 

Solve the model. The screen should look like Figure 12-7. 


( 5 i ) Input : 

==================== VARIABLE SHEET 

St Input Name Output Unit 



Comment 


==================== rule SHEET ========= 

S Rule 


-8=3*a-2*b+c-d+4*e 
-27=2*a-b-c+3*d+5*e 
1 5=a+b + c-2*d-2*e 
-2=3*a+3*b-c-d+2*e 
13=a+2*b+c-4*d+3*e 


Figure 12-7 

The Iterative Solver did not use the guess for the variable e , be- 
cause once the values of the other variables were known, e was 
uniquely determined. 

Although the guess for e was not used, it did not affect the solu- 
tion. You can set as many variables as you want for Automatic 
Iteration. The program will use the minimum number needed to 
solve the problem. 

Most models can be set to use Automatic Iteration, but its useful- 
ness varies from model to model. If a model is solved over and 
over again within a narrow range of input values, Automatic 
Iteration would be useful because the first guesses can all be pro- 
vided on the Variable subsheet and therefore need be entered only 
once. 

For other models, it may be too difficult to set first guesses that 
are general enough for Automatic Iteration to be beneficial. 
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Iteration and TRAVEL2 

Now let’s return to the TRAVEL2 model and solve a problem using 
the Iterative Solver. Reset the program, and load the model 
TRAVEL2. Display the Variable Sheet in a single window, and reset 
the variable values. 

Here is the problem: 

If you have a maximum of $25 to spend on fuel for a 500 mile 
trip, and gasoline costs $1.25 a gallon, at what speed must you 
drive your car to get the mileage you need to complete the trip? 
The value for internal friction is 1/3 Btu/s and the value for wind 
resistance is 9.5*10 A -6 hp*h A 3/mi A 3. 

Note: This problem is here strictly as an example to show the 
Iterative Solver working with travel. It gives one speed needed 
to complete the trip and does not maximize mileage. 

Before trying the Iterative Solver, try solving the model with the 
Direct Solver. If any units need to be changed, be sure you change 
the unit before you enter the input value. Enter the input values 
for the problem given above: $25 for cost , 500 mi for d , $1.25 for 
pr ; 1/3 Btu/s for/, and 9.5*10 A -6 hp*h A 3/mi A 3 for w. You want 
the output value for s to be in mi/hr, mlg in mi/gal, and t in h. 
Solve the model. 

The model was solved, but there is no solution for s , the value we 
are trying to find, or for t or power. Select the Rule Sheet and you 
can see that several equations were not satisfied. 

Since the Direct Solver seems unable to find the value for s, try 
using the Iterative Solver. Display the Variable Sheet again and 
move the value for mlg into the Input field by typing I in the 
Status field for mlg. 

Because the value for s is the value you are trying to find, it is a 
good variable to set as a guess. Enter a value of 45 for s and set it 
as a guess. Now solve the model. 

The screen should look like Figure 12-8. The model is completely 
solved. 
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(4s) Status: 

S Rule 

m lg = d/gas 
s=d / 1 

cost=gas*pr 

sssssssrsssssssssssss VARIABLE SHEET ================ 


St Input 

Name 

Output 

Unit 

Comment 

25 

m lg 


mi / g a l 

m i L eage 

500 

d 


m i 

distance 


gas 

20 

ga l 

amount of g 


s 

57.900465 

m i / h 

speed 


t 

8.6355093 

h 

time 

25 

cost 


$ 

cost of tri 

1 .25 

pr 


$ 

price of ga 


power 

2.3160186 

hp 

energy comp 

.33333333 

f 


Btu/s 

internal f r 

.0000095 

w 


hp*h A 3/mi 

wind resist 


Figure 12-8 


Conclusion 

This chapter has explained how the TKISolver program uses 
iteration and how the Iterative Solver works. This is the end of 
Part III. Part IV discusses lists, how to display and print graphs 
and tables of values, and how to define and use your own func- 
tions. 
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Part IV Lists 

TKISolver lists are lists of values, either numeric or symbolic. If 
you want to solve a single model for several different values of 
one or more of the variables, instead of entering one value at a 
time, you can enter a list of input values that can be used to solve 
for a list of output values. Lists also designate domains and 
ranges for functions, and are used to plot graphs and build tables. 

This part of the Instruction Manual is about lists of values and 
how they are created and used. 


Contents of Part IV 

• Chapter 13 Creating Lists 

• Chapter 14 The List Command 

• Chapter 15 Plots and Tables 

• Chapter 16 User Functions 
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Chapter 1 3 Creating Lists 

• The List Sheet 

• The List subsheet 

• The Fill List feature 

• Symbolic values 

• Saving a DIF file 

• Deleting a list 

This chapter is about the kinds of lists you can create and how to 
create them. As you work through this chapter, you will create 
four lists that you will use in examples in Chapters 14 and 16. 

This chapter also discusses the use of DIF format files and how to 
save files in DIF format using the DIF option (#) of the Storage 
command (/S). 


To begin this chapter: 

Reset the program. 

The List Sheet 

Lists and their characteristics are shown on the List Sheet. Dis- 
play the List Sheet in one window by typing: 

/ W 1 
= L 

The screen should look like Figure 13-1. 
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(In) Name : 

Name Elements Unit Comment 


Figure 13-1 

The List Sheet has the same relationship to the lists in a model as 
the Variable Sheet has to the variables. The List Sheet shows you 
the names and characteristics of each list in the model. 

There are four columns on the List Sheet. The Name column 
shows the names of the lists; the Elements column tells you how 
many values, or elements, are in each list; the Unit column shows 
the Display unit for the list; and the Comment column is for com- 
ments, notes, or descriptions. All of the columns contain entry 
fields except the Elements column, which contains output fields. 

The first three lists that you will create in this chapter will be used 
with a new model named mortgage. This model will be de- 
scribed in more detail in Chapter 14 when you begin using it. 

The first list to be created for MORTGAGE is named / and is a list of 
interest rates. In the first field in the Name column, enter the 
name of the list, i. 

List names have the same syntax as variable names. They must 
begin with a letter and may contain letters, numbers, and the 

characters @, #, $, %, and . If you try to enter a list name 

containing another character, such as a -I- or a blank space, the 
program will not accept it. 
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Because the Elements column contains output fields, it will be 
filled in automatically when you enter the values for the list. Skip 
over it for now and move to the first field in the Unit column. 

Lists have Storage units and Display units, similar to Calculation 
units and Display units for the variables. Units are entered for a 
list on the List Sheet just as they are entered for a variable on the 
Variable Sheet. The first unit you enter is both the Storage unit 
and the Display unit for the list. Subsequent entries change the 
Display unit, but not the Storage unit. Conversions between Stor- 
age and Display units, as between Calculation and Display units, 
must be defined on the Unit Sheet. When conversions are not de- 
fined, all values are assumed to be in Storage units. 

Because no unit conversions have been defined in this model, we 
will give the list i one unit for both the Storage unit and the Dis- 
play unit. Enter the unit name percent in the first Unit field. 

Comments are always ignored by the program during solutions. 
Enter the comment interest rate in the Comment field for the list 
/. 

The screen should look like Figure 13-2. 

(1 c) Comment: interest rate 

==================== LIST SHEET ==================== 

Name Elements Unit Comment 

percent interest rate 



Figure 13-2 
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The List Subsheet 

Like variables, lists have subsheets, and, like a Variable subsheet, 
the List subsheet is called with the Dive command (>). To fill in 
the values for a list, you must call the subsheet and enter the 
values there. Dive to the subsheet for / by placing the cursor any- 
where on the row containing the description of the list / and typ- 
ing: 

> 

The screen should look like Figure 13-3. 


(1 v) Value: 


interest rate 
percent 
percent 

E lement Va lue 


==================== LIST: 

Comment : 

Display Unit: 

Storage Unit: 


Figure 13-3 


The List subsheet is titled with the name of the list, in this case i. 

The List subsheet looks different from any of the sheets you have 
worked with so far. The top of the subsheet consists of three la- 
beled lines with one field per line, and the rest of the subsheet 
consists of two labeled columns. 

The first field contains the comment you entered on the List 
Sheet. The second and third fields show the Display unit and 
Storage unit. 
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All values entered in the list are assumed to be in the Display unit 
if the unit conversion has been defined on the Unit Sheet. The 
Storage unit is the unit used as a base for conversions of the list 
values, both to the Display unit and, during solution, to the Cal- 
culation unit of the associated variable. The program can make 
these conversions only if the unit conversions have been defined 
on the Unit Sheet. 

However, unit conversion is only part of the purpose of the Stor- 
age unit. If a list is saved in a DIF file, the value saved is in the 
Storage unit. When the DIF file is loaded, the value is converted 
from the Storage unit to the Display unit. Again, the program is 
unable to make these conversions if they have not been defined 
on the current Unit Sheet. DIF files and their use are discussed in 
the last section of this chapter. 

The Element column contains output fields. When you enter a 
value in a Value field, the program generates a number in the cor- 
responding Element field. This element number is positional and 
allows you to locate a particular value in a list. In the next chapter 
you will learn how to use the element number to get values from a 
list and put values into a list. 

Starting with the cursor in the first Value field, enter the follow- 
ing list of values by typing each value and then pressing I . 

Values for i 

16.375 

17 

16+1/2 

18 

17.45 
16 + 4/5 

The screen should look like Figure 13-4. Notice that when the 
values were entered, the expressions were evaluated and element 
numbers appeared in the Element column. 
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(6v) Value: 16.8 


Comment : 


interest 

Display 

Unit: 

percent 

Storage 

Unit: 

percent 

E l emen t 

Value 


1 

16.375 


2 

17 


3 

16.5 


4 

18 


5 

17.45 


6 

16.8 



Figure 13-4 

Note: If you try to enter an expression that includes a variable 
defined on the Variable Sheet, the program evaluates the value 
using the Calculation unit and not the Display unit. 

Return to the List Sheet with the Return command (< ), and notice 
that the Element field for / has been filled in with a 6, the number 
of values in the list. The list / is now defined and ready to be used. 

The Fill List Feature 

The next list to be created for the mortgage model is a list of 
values describing the possible payment periods, or term, for a 
mortgage. Move the cursor into the Name field of the next row, 
and name this list term . Enter the Display unit years and the com- 
ment payment period, then dive into the subsheet. 

The values for term , in years, are to run from 5 to 50 in intervals 
of 5. You could enter all the values one at a time, but the values 
can be entered automatically using the Fill List feature. 
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The Fill List feature can be used if a list is to be numeric with the 
numbers evenly spaced. Given the first and last values in a list, 
the Fill List feature interpolates the intervening values and enters 
them. It can be used only on a sheet containing list values and is 
called by the Action command (!). 

In the first field in the Value column, enter the value 5 . Move the 
the cursor to the 10th element by typing: 

: 1 0 ♦ 

Enter the value 50. 

The screen should look like Figure 13-5. 

( 1 0 v ) Value: 50 


Comment : 
Display Unit: 
Storage Unit: 
E l ement Value 

1 5 


10 50 


Figure 13-5 

Now press the Action command (!). The message is: 

Fill List: Y N 

This request for confirmation is to prevent you from accidentally 
writing over values that may already be in the list. 

Type Y. The screen should look like Figure 13-6 with the values 
for term filled in. 


LIST: term =========== 

payment period 

years 

years 
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(1 Ov) Value: 50 


LIST: term ========== 


Display Unit: 
Storage Unit: 
E lement Va lue 


Comment : 


payment period 

years 

years 


2 

3 

4 

5 

6 

7 

8 

9 

10 


5 

10 

15 

20 

25 

30 

35 

40 

45 

50 


Figure 13-6 

The list term is now defined. The last list to be created for MORT- 
GAGE is a a list of bank names. 

Symbolic Values 

Lists may contain symbolic as well as numeric values. Return to 
the List Sheet with the Return command « ), and create a new list 
named B with the comment bank names. Because this is a list of 
symbolic values, it does not need a unit. 

Dive into the subsheet. 

An apostrophe (’) tells the program that what follows is a sym- 
bolic value. Symbolic values have the same restrictions as 
TK! Solver variable and list names. They must begin with an al- 
phabetic character and may contain letters, numbers, and the 

characters @, #, $, °7o, and . They may not contain blank 

spaces or operators. 

The first bank on the list is named the First National Bank. Be- 
cause you cannot enter blank spaces for a symbolic value, use un- 
derscores instead. With the cursor in the first Value field type: 

'First National^ 
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Here is an example of how to use the Edit command (0). If you 
forget to type an apostrophe, 0 calls the Editor. The next bank is 
named Main Street Bank. Move the cursor to the second Value 
field and type but do not enter: 


Main_Street 

Note: If you tried to enter the value as shown above, you would 
get an error message because the apostrophe (’) is missing, and 
the program would automatically call the Editor. The cue would 
move to the place where the first error is suspected. 


Type 0 to call the editor. Move the cursor to the beginning of the 
field with t and add the missing apostrophe (’). Enter the value 
with ♦ . 

Note: This command can also be used to edit an item on the 
Prompt/Error line, such as a filename you may have misspelled. 

Complete the list by entering the remaining four bank names in 
the order given below. Enter them, typing underscores in place of 
the blanks, with an apostrophe before each name to tell the pro- 
gram that it is a symbolic value. 

Values for B 

Family Savings 
County Bldg and Loan 
City Cooperative 
Little River Federal 

The screen should look like Figure 13-7. 
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(6v) Value: ' Li t t le_Ri ver_Federa L 

Comment : 

Display Unit: 

Storage Unit: 

E lement Va lue 


1 * F i r st _Nat i ona l 

2 ' Ma i n_S t reet 

3 ' Fami ly_Sa vi ngs 

4 ' Count y_B ldg_an 

5 ' C i t y _Coope rat i 

6 ' Li tt le Ri ver_f 


Figure 13-7 

The lists for MORTGAGE are now all entered. The last list to be 
created is a list of mileages for the model TRAVEL2. 

Creating the List for TRAVEL2 

Return to the List Sheet using the Select command (= ) and move 
the cursor down to the next blank row. 

Except for the list name, all the characteristics of a list can be 
entered on the List subsheet. Name the list mlg and dive into the 
subsheet. 

Enter the comment mileage and both the Display and Storage 
unit as km/1. 

The values for mlg are from 4.251 to 19. 1295 and there are eight 
elements in the final list. Enter 4.251 as the first value and 
19.1 295 as the eighth, then use the Action command (! ) to fill the 
list. 

Return to the List Sheet. The screen should look like Figure 13- 
8. All of the information has been filled into the row for mlg. 


bank names 
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( 4n ) 

Name : m l g 



= = = = = 

n 

ii 

ii 

ii 

ii 

ii 

ii 

ii 

ii 

ii 

ii 

ii 

ii 

ii 

= LIST SHI 

ITI 

m 

—i 

11 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

Name 

E l emen t s 

Unit 

Comment 

i 

6 

percent 

interest rate 

term 

10 

years 

payment period 

B 

6 


bank names 

m lg 

8 

km/ L 

mi leage 


Figure 13-8 


Saving a DIF File 

DIF is a standard format for storing information. It allows dif- 
ferent programs, all using the same storage format, to use the 
information in a single file, and avoids the necessity of saving the 
same information over again in different formats for different 
programs. 

If you save a list in a DIF file, you can load the values into an- 
other program that uses the DIF format. Conversely, if you have 
a DIF file of values from another program, those values can be 
loaded into the TK!Solver program as a list. 1 

Normally when you are using a list with different models, you use 
the Save Model option (S) and the Load File option (L) of the 
Storage command (/S) to save and load the file containing the 
list. The DIF option (#) should be used only when lists are to be 


1 For information about the DIF format and programs that use it, write to: 
DIF Clearinghouse 
PO Box 638 

Newton Lower Falls, MA 02162 
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shared between programs, when the values are going to be used in 
another program, or when values from another program are go- 
ing to be used with the TKISolver program. However, as an ex- 
ample of how to save a DIF file, the following section shows you 
how to save the list mlg in a DIF file. In the next chapter you will 
load it again from the DIF file. 

The DIF option (#) of the Storage command (/S) can be used to 
save and load only lists. If you are going to save a list in a DIF 
file, you must be on the List Sheet. The cursor must be on the row 
containing the list you want to save before you type the com- 
mand. Move the cursor to the row describing the list mlg and type 
the Storage command with the DIF option: 

/S# 

The message is: 

D I F Storage : S L 

These choices are Save (S) and Load (L). Type: 

S 

The prompt is: 

DIF Save: Point to last list (4n) 

If you want to save more than one list, you could use the cursor to 
point to a block of lists on the List Sheet and they would all be 
saved in the file. 

Because mlg is the only list to be saved, press 
The prompt is: 

DIF Save: Filename: 

The cue is on the Prompt/Error line so that you can type in the 
filename, just as for any other Storage command. Enter the file- 
name TLIST. 
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The program names the file TLiSTand adds the DIF extension so 
that any program that uses DIF files can identify it. The informa- 
tion saved in the DIF file consists of the values in the list ex- 
pressed in the Storage unit. Both Display and Storage unit names 
are saved, but the conversion is not. You must be sure that the 
conversion is defined on the Unit Sheet before you load the DIF 
file into a model. 

Deleting a List 

You can delete a list by deleting the row on the List Sheet. The list 
mlg has been saved for later, so delete the row using the Delete 
command (/D). 

Dive into the subsheet for that row. The list is gone. 

The lists for mortgage have been created, and the list for 
TRAVEL2 has been created, saved in a DIF file, and deleted from 
the current List Sheet. The current information can now be 
merged with the model mortgage. 

Do this by loading the Instruction File MORTGAGE. Save the new 
version of mortgage again using the same filename. 

Conclusion 

This chapter has shown you how to create lists. The next chapter 
explains the List command (/L) and how to use it. 
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Chapter 1 4 The List Command 

• The List command (/L) 

• The Solve option (!) 

• Creating a list through the Variable Sheet 

• Changing list associations 

• Loading a DIF file 

• The Block option (B) 

• The Get (G) and Put (P) options 

One of the ways to use lists of values is with the List command 
(/L). The List command has several options that use lists in asso- 
ciation with variables. Once a list has been associated with a vari- 
able on the Variable Sheet, the values in the list can be used for 
input or output values of the variable and can be manipulated 
from the Variable Sheet. 

This chapter is about the List command, what it is, and how to 
use it. 


To begin this chapter: 

At the end of the last chapter, the MORTGAGE model was loaded. 

If you quit after the last chapter, load the program, then load the 
mortgage model that you saved at the end of Chapter 13. 

Display the Variable Sheet in a single window. The screen should 
look like Figure 14-1. 

The MORTGAGE Model 

In this chapter you will use a new model named mortgage. The 
mortgage model is set up to show the relationships between 
variables for a major credit purchase. It can be used to determine 
several values, including monthly payment amount, term of pay- 
ment, down payment percentage, and interest rate. The model 
has nine variables in five equations. 
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( 1 i ) Input: 


ii 

11 

II 

II 

II 

II 

II 

VARIABLE 

SHEET = = = == 

r sssssrssssss 

Name 

Output 

Unit 

Comment 

H 


dollars 

House price 

d 


dollars 

Down paymen 

dp 


percent 

Down paymen 

P 


dollars 

Mortgage 

n 


years 

Term 

i 


percent 

Interest ra 

A 


dollars 

Monthly pay 

T 


dollars 

Total of pa 

Tip 


dollars 

Total inter 


Figure 14-1 

Display the Unit Sheet for the MORTGAGE model in the bottom 
window. You can see that it contains no unit conversion defini- 
tions. Because some of the variables in the model have different 
Display and Calculation units, these unit conversions must be de- 
fined before values are entered in the model. 

If unit conversions have not been defined, values entered on the 
Variable Sheet are assumed to be in Calculation units. If you en- 
ter a value before defining the necessary conversions on the Unit 
Sheet, some or all of your values may be incorrect. 

The units file that you created in Chapter 8 contains the units you 
need for mortgage. Load the file munits. Redisplay the Rule 
Sheet in the bottom window and save the new version of mort- 
gage. 

The List Command 

The List command (/L) has several options that enable you to 
manipulate lists of values by associating them with variables on 
the Variable Sheet. These options include the means to use lists or 
partial lists as input and output values with either the Direct or 
Iterative Solver. 
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The four options are: 

Option 

Effect 

Solve (!) 

Solves the model for all the values in the associ- 
ated list or lists. 

Block (B) 

Solves the model for a given block of values 
within a list. 

Put (P) 

Puts the current value of each variable associated 
with a list at a designated element in the associ- 
ated list. 

Get (G) 

Gets a value from each associated list from a des- 
ignated element in the list and displays it as the 
current value of the variable. 


The Solve Option 

The Solve option (!) of the List command (/L) uses either the 
Direct or Iterative Solver, according to the needs of the problem, 
and uses lists for the input and output values. 

The problem given below is a typical application of the MORT- 
GAGE model. 

A house is offered on the market for $95,000. A bank charging 
17.5% interest requires 20% down payment. How is the monthly 
payment amount for this mortgage affected by the term of the 
loan? 

You can use the Solve option (!) of the List command (/L) to 
solve this problem, giving a list of terms as input values and solv- 
ing for a list of relative monthy payment amounts. 

Preparation for the Solve Option 

To use the Solve option (!) you must do two things. You must tell 
the program which variables are to be associated with lists, and 
you must tell it which of those lists should be used for input 
values, as opposed to those that will receive output values. 

In this example, two variables will be associated with lists. The 
variable n requires an input list because it represents the term. 
The changes in the value for the term changes the value of the 
monthly payment amount, represented by the variable A. There- 
fore, A will be associated with an output list. 
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A variable is designated as an input variable by giving it an arbi- 
trary input value. Because n will use a list of input values, you 
must give it an input value so that the program recognizes it as an 
input variable. 

Although it is not necessary, it is usually a good idea to solve the 
model once before using the List command (/L), just to be sure 
the problem is correctly stated. Enter the values given in the prob- 
lem above and the arbitrary value of 25 for the variable n to des- 
ignate it as an input variable. 

Note: Commas (,) are not accepted in the Input field, so don’t 
try to enter the comma as part of the house price. 

Solve the model. The screen should look like Figure 14-2. 

(5 i ) Input : 25 


========= 

it 

ii 

ii 

ii 

it 

ii 

ii 

ii 

VARIABLE 

SHEET === 

============= 

Input 

Name 

Output 

Unit 

Comment 

95000 

H 


do l tars 

House price 


d 

1 9000 

dollars 

Down paymen 

20 

dp 


percent 

Down paymen 


P 

76000 

dollars 

Mortgage 

25 

n 


years 

Term 

17.5 

i 


percent 

Int e rest ra 


A 

1122.9226 

do l l a r s 

Monthly pay 


T 

336876.77 

dollars 

Total of pa 


Tip 

260876.77 

dollars 

Total inter 


Figure 14-2 

If the model solved correctly, the program knows which values 
are input and which are output. Next, identify the variables to be 
associated with lists. 

An L in the Status field of a variable associates that variable with 
a list. An L can be entered in a Status field by two methods. We 
will use one method for A and the other for n. 
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Move the cursor to the Status field for the variable A and type: 

L 

Now dive to the Variable subsheet for A. 

The L that you entered on the Variable Sheet appears in the Status 
field. 

The third field on the subsheet is the Associated List field and 
contains the name of the list that is associated with the variable, 
in this case A. If this field is blank when you type an L in the 
Status field on the Variable Sheet, the program automatically 
uses the variable name for the name of the associated list. 

If you want to look at the associated list, you can dive from the 
Variable subsheet to the List subsheet. It does not matter where 
the cursor is on the Variable subsheet. Dive to the List subsheet 
for A. 

List A is currently empty. The variable A is an output variable, so 
list A will be filled, during solution, with output values. 

Notice that the Calculation and Display units for variable A have 
become the Storage and Display units, respectively, for list A. 
Units are automatically generated for a list only when it is a new 
list created by setting a list association on the Variable Sheet. 

The Return command (<) calls the previous sheet. Return to the 
Variable Sheet by typing the Return command twice «<). 

The other method of associating a variable with a list will be used 
for n. Move the cursor to the row containing the variable n and 
dive to the Variable subsheet. 

In Chapter 13 you created a list of payment periods named term , 
and then saved it as part of the mortgage model. This is the list 
you want to associate with the variable n. 

Move the cursor to the Associated List field and enter the list 
name term. Notice that the Status field immediately shows L. 
Whenever a name is entered in the Associated List field, the pro- 
gram automatically enters an L in the Status field of the variable. 
If there is no list with that name, an empty list is created. 
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Review the values in the list term by diving to the List subsheet for 
term . As you can see, it is the same list you created in the last 
chapter. 

Use the Select command ( = ) to display the Variable Sheet and 
notice that there is an L in the Status field for n. 

Note: If you reset the variable values with the Variable Value 
option (V) of the Reset command (/R), the list associations are 
left intact. 

Using the Solve Option 

You have designated your input variables and set your two list 
associations, so you are now ready to use the List command (/L) 
with the Solve option (!). Because the Solve option calls one of 
the Solvers, the messages that appear when the Solvers are run- 
ning also appear when this option is used. The intermediate 
values for this solving will be the values in the lists, so they are of 
interest. Check the Global Sheet to be sure that the Intermediate 
Redisplay ON field is set to Yes, then return to the Variable Sheet. 

Type the List command: 

/L 

The message is: 

List: ! B P G 
Type the Solve option: 

! 

The values that appear on the Variable Sheet are the input and 
output values in the lists. While the Direct Solver solves using 
each element in the input list, the message is: 

List Solver: element number ; Direct Solver 

The element number is incremented as each element of the input 
list is used. The element number would be shown even if the In- 
termediate Redisplay ON field was set to No, although the input 
and output values would not be shown. 
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Because the Solve option (!) can run with either the Direct or 
Iterative Solver, this message also shows which solver is being 
used. When the message clears, the Direct Solver has finished. 
The original values are redisplayed at the end of solution. 

Type the Dive command twice (> > ) to display the List subsheet 
for list n. Use the Window command (/W) with the List Sheet 
option (L) to split the screen and display the List Sheet in the bot- 
tom window. Then dive to the List subsheet for list A in the bot- 
tom window. 

The output values in list A are in the same order as the input 
values in list n. If you scroll down to look at the last few elements 
in both lists, you can see that the last few values in list A are all 
very close. When you compare the corresponding elements in list 
n and list A, you can see that the impact of varying the length of 
the payment period almost vanishes around 35 years, although 
the overall cost is quite different. 

Note: If the program is unable to solve for a value, that element 
in the output list will be left blank. 

Creating a List Through the Variable Sheet 

In Chapter 13 you created lists using the List Sheet. Since you can 
display a List subsheet by diving from the Variable Sheet, you can 
also create a list by diving down from the Variable Sheet. Lists 
created through the Variable Sheet are automatically recorded on 
the List Sheet. 

The list you are about to create will be used with a second MORT- 
GAGE example. This problem examines how different down pay- 
ments affect the monthly payment amount. 

Display the Variable Sheet in a single window. Set the variable dp 
as a list variable by typing L in the Status field, then dive down to 
the List subsheet for the new list dp. 

Enter the comment down payment % . The Display and Storage 
units have been assumed from the variable Display and Calcula- 
tion units. Use the Fill List feature to enter 10 values from 5 to 50. 

The screen should look like Figure 14-3. 
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( 1 Ov ) Value: 50 


Comment : 
Display Unit: 
Storage Unit: 
E l ement Value 


1 
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decimal_form 


% 


Figure 14-3 

Return to the Variable Sheet. 

Changing List Associations 

Of the two variables associated with lists from the previous solu- 
tion of the model, only one is needed for the new problem, the list 
associated with the variable A. Because the variable dp is associ- 
ated with the input list, the list association for variable n is not 
required for this problem. 

The List option (L) in the Status column acts as a switch both to 
associate and disassociate a list. If a variable has a list associated 
with it, the association can be broken by typing L in the Status 
field. Move the cursor to the Status field for the variable n and 
type L. The L that was there disappears. The association has been 
broken, but the list remains intact. 

The variable A is still associated with a list of output values. 
When you solve the model again, the new output values will re- 
place the old ones. 

If you want to save the old values, you must rename the list. The 
current list A is needed later in the manual, so the list must be 
renamed. Display the List Sheet using the Select command ( = ). 
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Change the name of list A to A1 by editing the current list name 
or entering the new name in the name field for A . Now the list A 1 
contains the old values and list A is empty. 

Call the Global Sheet and set the Intermediate Redisplay ON 
field to No. This speeds up the solution process. Redisplay the 
Variable Sheet. 

The model has been solved once with the variable dp as an input 
variable and the variable A as an output variable, so you do not 
have to designate them again as input and output. The value for 
the variable n can remain as it is. 

Type the List command, /L with the Solve option, !. 

The message is the same as it was the last time you ran the Solve 
option, but the list values are not shown during solution. Because 
the program does not have to stop to show each value, the time 
needed to reach the solution is much less. 

The List Command with TRAVEL2 

The next example uses the TRAVEL2 model and the DIF file TLIST 
to show you the Block option (B) of the List command (/L). 

Save the newest version of the mortgage model with the new 
lists, then reset the program and load the TRAVEL2 model. 

Loading a DIF File 

In Chapter 13 you saved a list for TRAVEL2 in a DIF file. Nor- 
mally, information would be loaded from a DIF file only if it 
were used in another program. The DIF file TLIST is used in this 
chapter to show you how to load a DIF file. 

Load the DIF file by typing the Storage command (/S) with the 
DIF option (#) and then choosing Load (L): 

/SUL 

The message is: 

DIF Load: Filename: 
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As for the other options of the Storage command (/S), the cue is 
left on the Prompt/Error line so that you can enter the filename. 
Type: 

TLIST ♦ 

While the file loads, the message is: 

Loading from TLIST DIF extension 

When the message disappears, the file is loaded. 

Display the List Sheet. The list mlg has been loaded. 

Display the Variable Sheet in the top window and the Rule Sheet 
in the bottom window, then save the new version of the travel 
model in a file named TRAVEL3 . 

Note: Lists are saved with all their characteristics, but if a list 
already on the List Sheet has the same name as one that is being 
loaded, the two lists are not merged. The new list is loaded with 
the Name field blank, even though the list name is stored in the 
DIF file. 

Note: Because list names must follow the TKISolver program’s 
convention for names, list names beginning with a number, saved 
from other programs, are not recognized as list names by the 
TKISolver program. 

The Block Option 

The Block option (B) of the List command (/L) works exactly as 
the Solve option (!) except that it operates on a specified block of 
elements within the lists instead of on the full lists. 

The model must be prepared for the Block option just as it is pre- 
pared for the Solve option. First designate the input variables by 
giving them arbitrary values, then associate lists with the appro- 
priate variables. 

This example reintroduces the hypothetical car that was used in 
Chapter 7. The solution to the problem requires iteration. We will 
use automatic iteration. Because it is not possible to choose a first 
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guess value that solves the model for every value in the list mlg , 
the Block option (B) of the List command (/L) will be used to 
solve for the greatest possible range of values. 

The experimental car now has an internal friction factor of 0.65 
Btu/s and wind resistance of 3.5*10 A -6 hp*h A 3/mi A 3. Given a 
trip of 500 miles, what speeds can be traveled to obtain the mile- 
ages in the list mlgl 

Because the problem is concerned with the effect of speed on 
mileage using the factors for internal friction and wind resistance 
as stated in Chapter 7, the equation on the Rule Sheet dealing 
with cost, cost = gas *pr ; is extraneous to this application. Mask it 
by moving the cursor to that rule, calling the Editor, and adding a 
quotation mark (”) before the first character. The program now 
treats this equation as a comment and the program will use the 
four remaining equations. 

On the screen, display one window containing the Variable Sheet. 
Because cost and pr are in the masked rule only, there are eight 
variables used in this example, and the model requires four input 
values for solution. 

First determine which variables will be associated with lists and 
which must be designated as input variables. Since the example 
explores the relationship of mileage to speed, the variable mlg 
will use the list mlg for input values and the variable 5 will require 
a list for output values. 

If your Variable Sheet has values, reset them using the Variable 
Values option (V) of the Reset command (/R). Enter the values 
given in the problem along with the arbitrary value 25 mi/gal for 
mlg y so that it is marked as an input variable. The screen should 
look like Figure 14-4. 

The list mlg contains values for the variable mlg that can be used 
to solve for a list of values for the variable s. 

Associate the variable mlg with the list mlg. Because they have the 
same name, you have only to type L in the Status field for the 
variable mlg. 
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(4s) Status : 

= = := = = = := = := = = = = = = = := = = =: VARIABLE SHEET 


St Input 

Name 

Output 

Unit 

Comment 

25 

mlg 


m i / g a l 

mi l eage 

500 

d 


m i 

d i stance 


gas 


ga l 

amount of g 


s 


mi / h 

speed 


t 


h 

t i me 


cost 


$ 

cost of tri 


pr 


$ 

price of ga 


power 


hp 

energy comp 

.65 

f 


Btu/s 

internal fr 

.0000035 

w 


hp*h A 3 /m i 

wind resist 


Figure 14-4 


Now dive to the Variable subsheet for the variable mlg. As you 
can see, the list association is set. Look at the units. Both Calcula- 
tion and Display units for the variable mlg are in mi/gal. Dive to 
the List subsheet for the list mlg. Here both the Display and Stor- 
age units are km/I. 

Table 14-1 below shows the units for the variable mlg and the 
associated list mlg . 

Variable mlg List mlg 

Display unit Display unit 

mi/gal km/1 


Calculation unit 
mi/gal 

Table 14-1 


Storage unit 
km/1 


When an existing list is associated with a variable, either the Cal- 
culation and Storage units must be the same, or there must be a 
conversion defined between them on the Unit Sheet; otherwise 
the values used and produced by the List command (/L) will be 
inaccurate. 
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The conversion between mi/gal and km/1 is defined on the Unit 
Sheet, and the program can make the conversion. 

In this example, all necessary unit conversions have been defined, 
so the model can be solved in its current state. But while you are 
working on this problem, it would be more convenient if the Dis- 
play units were the same for the variable and the list. 

Change the Display unit for the list to mi/gal. Now, even though 
they are stored in the DIF file as km/1, in this model the values for 
the list mlg are shown in mi/gal. 

Return to the Variable Sheet and associate the variable s with the 
list s. 

Because the variables is a guess variable for iteration, it requires 
a guess value for each element that will be in the output list. There 
are two ways to set these values. You can either use Automatic 
Iteration, or you can enter a set of first guesses in the list s. A list 
of first guesses would be overwritten automatically as the output 
values were generated. 

This example sets the guess value for the variable 5 using Auto- 
matic Iteration. The program will use the First Guess value on the 
Variable subsheet for 5 as the first guess in an Iterative solution 
for each value in the output list. 

In some cases this may not be a successful guess for all of the 
elements. If you use this method of setting a first guess for an 
Iterative solution of lists, you must be sure to examine the results 
carefully to be sure that they are sensible results. 

Check the Global Sheet to be sure the Automatic Iteration ON 
field is set to Yes, and return to the Variable Sheet. 

Dive to the subsheet for the variable s and enter 20 in the First 
Guess field. The model is now ready for solution. 

In this example, we will use the Block option (B) to solve the 
model for the second through sixth elements in the list mlg rather 
than for the whole list of values. 

Return to the Variable Sheet and type: 

/LB 
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The prompt is: 

List Block: First element: 

This prompt asks you for the element number of the first value in 
the block of values that you want to use. Since we are interested in 
the values for elements 2 through 6, type: 

2 ♦ 

The next prompt is: 

List Block: Last Element: 

The last element to be used is element 6, so type: 

6 ♦ 

While the model is being solved for these five elements, the mes- 
sage is: 

List Solver: element, Iterative Solver, 

step out of estimate 

Notice that this is the same message that appears when you use 
the Solve option. The Block option is exactly the same as the 
Solve option, but the Solver is applied only to a specific section of 
the list. 

Because the program runs the Iterative Solver for each element in 
the specified block, it takes time to complete the solution. 

When the message disappears the Iterative Solver has solved the 
model for the five elements, but no value for 5 is shown on the 
Variable Sheet. 

Dive to the List subsheet for 5. Your screen should look like Fig- 
ure 14-5. These values are the set of speeds required for the spec- 
ified mileages in this hypothetical car. 

Notice that the element numbers of the values in the list s corre- 
spond to the element numbers of the input values in the list mlg , 
even though the list contains no other values. 
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( 1 v ) Value: 


LIST: s 


Comment : 


Display Unit: 
Storage Unit: 
Element Value 


m i / h 
m i / h 


2 

3 

4 

5 

6 


13.94790435 

18.87821891 

24.25812781 

30.62755156 

40.12852363 


Figure 14-5 

The Get and Put Options 

The Get (G) and Put (P) options of the List command (/L) can be 
used to look at a particular instance of a model. The Get option 
(G) tells the program to get a specified element from each associ- 
ated list and show the values on the Variable Sheet. The Put op- 
tion (P) of the List command (/L) puts the current values of all 
variables associated with lists into the lists at a specified element. 

Return to the Variable Sheet. 

The Block solution of the TRAVEL3 model did not provide a value 
for the first element of the list s. The Get (G) and Put (P) options 
of the List command (/L) can be used to find this value. 

To see the value for the first element in the list mlg , use the List 
command (/L) with the Get option (G). The cursor can be any- 
where on the sheet. Type: 

/ LG 

The prompt is: 

Get from element: 


14-15 


TKISolver Instruction Manual 


This prompt asks for the element number of the value you want 
to see. We are interested in the first element, so type: 

1 ♦ 

The program gets all first elements in associated lists and displays 
them. 

The values shown for the variables mlg and s are those stored as 
the first element in their respective lists. The list s has no value at 
the first element. Set the variable s as a guess variable with a value 
of 10. The L remains in the Status field. A variable may be both a 
guess variable and associated with a list. 

Solve the model. The screen should look like Figure 14-6. 

(4i) Input: 


VARIABLE SHEET 


St 

Input 

Name 

Output 

Unit 

Comment 

L 

10 

m tg 


mi /ga l 

mi Leage 


500 

d 


m i 

d i stance 



gas 

50 

ga L 

amount of g 

L 


s 

9.2311630 

m i / h 

speed 



t 

54.164356 

h 

t i me 



cost 


$ 

cost of tri 



P r 


$ 

price of ga 



power 

.92311630 

hp 

energy comp 


.65 

f 


B t u / s 

internal f r 


.0000035 

w 


hp*h A 3/mi 

wind resist 


Figure 14-6 

When the value has been found, you can replace the null value in 
the first element of list s with the new value by using the Put op- 
tion (P). 

Use the List command (/L) with the Put option (P). Type: 

/ LP 
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The prompt is: 

Put to element: 

This value is to be the first element, so type: 

1 ♦ 

Dive to the List subsheet for 5 and look at the first element. The 
value has been changed. Because the value of the first element in 
the list mlg was not changed on the Variable Sheet, it was not 
changed in the list. 

Save TRAVEL3. 

Note: The purpose of this example is to demonstrate the use of 
the List command (/L). It explores only one of several possible 
sets of answers that can be obtained using this model. You can 
explore the problem yourself by changing the first guess value to 
determine maximums and minimums. 


Conclusion 


This chapter described the List command (/L) and how to use it. 
The next chapter describes how to use lists to plot graphs and 
print tables of values. 
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Chapter 1 5 Plots and Tables 

• The Plot Sheet 

• The display scale 

• The Table Sheet 

When you have solved a problem using lists for input and output 
values, you may want to compare the values in two or more of the 
lists. The TKiSolver program provides two methods for com- 
paring values: plots and tables. TKiSolver plots and tables can be 
displayed on your screen, printed on a printer, or written in print 
files. 

This chapter tells you how to use the Plot and Table Sheets to 
produce plots and tables of list values. 


To begin this chapter: 

Reset the program. 

The N POWER Model 

The model used to show you how to produce plots and tables is 
named npower and is on your Instruction diskette. Load the file 
npower. The screen should look like Figure 15-1. 

npower is a simple model that finds the square and the cube of n . 
Using this model, you will create lists associated with the vari- 
ables a , b 9 and c, and then compare them. 

The npower model includes a list named n that you can see if you 
look at the List Sheet. This list will be associated with the variable 
n. First, set the variable n as an input value by giving it the arbi- 
trary value of 1. Then associate all the variables, including n , 
with lists by typing L in each of their Status fields on the Variable 
Sheet. 

When the model is solved using the values in the list n as input 
values, lists of output values will be created for the variables a 9 b, 
and c. 
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C 1 r ) Rule: a=n 

==================== VARIABLE SHEET ============ 

St Input Name Output Unit Comment 


a 

n 

b 

c 


==================== RUL E SHEET 

S Rule 

* a = n 

* b = n A 2 

* c=n A 3 


Figure 15-1 

Solve the model using the List command (/L). When it has fin- 
ished, save the new version of the NPOWER model, with the three 
new lists a , b , and c, writing over the old version of the model. 

The Plot Sheet 

The information that you enter on the Plot Sheet tells the pro- 
gram which values you want to plot and how you want the plot to 
look. Display the Plot Sheet in a single window by typing: 

/ W 1 
= P 

The Plot Sheet, like the List subsheet, has labeled lines at the top 
of the sheet, each with one field, and columns filling the rest of 
the sheet. 

The first row on the sheet is the Screen or Printer field. It is an 
option field with the default Screen. If this field is set to Screen, 
the plot is shown only on your screen. If you have a printer, you 
can type a P in this field to send the plot to the printer or to a print 
file. The specifications for the printer are set on the Global Sheet 
as described in Chapter 9. 
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If the Screen or Printer field is set to Printer, the plot is shown on 
your monitor while it is being printed. Because it is scaled for the 
printer, the plot may not be readable on the screen. 

The second field on the sheet is the Title field. Anything that you 
enter in this field is printed as a title at the bottom of the plot. 

The third field is the Display Scale ON field with the default of 
Yes. If this field is set to Yes, the numbers used for scaling the plot 
are shown along both axes. If it is set to No, no scale values are 
shown. 

The last field at the top of the sheet is the X-Axis field. The pro- 
gram uses the values in the list named here as the ^-coordinates. 
You can enter any legal name in this field, but if it is not the name 
of a list, or if the list is blank, you will receive an error message 
saying that no values are available for the plot. 

There are two columns filling the rest of the sheet. The left col- 
umn is the Y-Axis column. The program uses the values in the lists 
named here as the ^-coordinates for the plot of each point. More 
than one list can be used for ^-coordinates. 

The Character field for each Y-Axis list tells the program which 
single character to use when plotting with that set of y- 
coordinates. You can use any printable character for a plot, but if 
you want to use a command character, such as /, = , or you 
must use either 0 or /E to type it in the field. You can type only 
one character in each field of the Character column. ♦ is not re- 
quired. 

Plot the values in the list n against the other three lists by giving 
the Plot Sheet the following settings: 

• The plot should be displayed on your screen, so if the first field 
on the sheet is not set to Screen move the cursor to that field 
and type S. 

• In the second field, enter the title Plot of n. 

• The Display Scale field should be set to Yes. If it isn’t, move the 
cursor to that field and type Y. 

• The list to be used for the x-axis is the original list, n. Move the 
cursor to the X-Axis field and enter the list name n. 

• The plot will relate the values in n to the corresponding values 
in the lists a , b , and c. Move the cursor down to the first Y-Axis 
field and enter the list name a. 
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The default plot character is an asterisk. It appears automati- 
cally in the first Character field. The plot of n to a will be 
shown using asterisks. 

• Now move the cursor down and enter the list names b in the 
second Y-Axis field and c in the third. Asterisks are automati- 
cally entered in their Character fields as well. 

• Because we want to see how the graphs for the three lists differ, 
each plot should use a different character. Move the cursor to 
the Character field for b and type the character #. The Charac- 
ter field accepts only one character and does not require ♦ . 
Move the cursor to the Character field for c and enter the char- 
acter o. 

Look at the plot by typing the Action command (!). 

The screen should look like Figure 15-2. This is the plot of n re- 
lated to a , b , and c, represented by the characters set on the Plot 

Sheet. Notice the title at the bottom of the plot. 

8 + 


6 + 


4 + 


2 + 


o 


0 


0 

1 

+ 

1 


Figure 15-2 


o 



15-4 


TKISolver Instruction Manual 


Note: The program plots one character per point. If points 
overlap, the last one takes precedence. 

Note: If the plot is a complex one the program may require a 
minute or more to produce it. 

The Display Scale 

The values shown on the x- and y-axes of the plot are generated 
by the program. Based on the highest and lowest values in the 
X-Axis list, it produces evenly spaced values that are shown as the 
scale for the x-axis. 

The values for they-axis are produced in a similar manner, except 
that all the Y-Axis values are combined, and the highest and low- 
est values of the combined lists are the ones used for the scale. 

You can turn off the display of the scale values by setting the Dis- 
play Scale ON field to No. 

When you have finished looking at or printing the plot, return to 
the Plot Sheet by pressing ♦ . 

The Table Sheet 

Another way of comparing lists of values is by looking at them in 
a table. The information that you enter on the Table Sheet tells 
the program which values you want shown as a table and how you 
want the table to look. Display the Table Sheet by typing: 

= T 

Like the Plot Sheet, the Table Sheet has labeled lines at the top of 
the sheet, each with one field, and columns filling the rest of the 
sheet. 

The first field on the Table Sheet is the Screen or Printer field and 
is exactly like the one on the Plot Sheet. It is an option field with 
the default Screen. If the first field is changed to Printer, the table 
appears on the screen while it is being printed on the printer or 
written to a print file. 

The second field on the Table Sheet is the Title field. Like the 
Title field on the Plot Sheet, it is for the title of the table. The title 
is shown at the top of the table. 


Chapter 15 

Plots and Tables 


The third field sets the table to be either vertical, with the values 
in each list shown from top to bottom, or horizontal, with the 
values in each list shown from left to right. This field is an option 
field with the default of Vertical. 

The List column contains the names of the lists to be shown in the 
table. 

The Width column tells the program how many characters wide 
the columns in the table are to be. The width must be an integer. 
The default is 10 . 

The First column contains the element numbers of the first value 
in each list that is to be in the table. Because the number repre- 
sents an element, the number must be an integer. The default is 1. 

The Header column contains the header or title that appears at 
the beginning of each list in the table. 

When you enter a list name, the Width and First fields are filled 
in with the default settings. You can change them according to 
your needs. 

The Header field may remain blank. 

Set up the Table Sheet for the four lists in NPOWER using the fol- 
lowing settings: 

• Leave the first and third fields at their defaults, Screen and 
Vertical. 

• Give the table the title Powers of n. 

• In the List column, enter the names of the four lists— n, a, b, 
and c. 

• Leave the column width at 10 characters and the first element 
as 1. 

• In the Header column, enter a header for each list — List n for 
/?, n A l for a , n A 2 for b , and n A 3 for c. 

Look at the table by typing the Action command (!). The screen 
should look like Figure 15-3. 
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List n n A 1 


n A 2 


Powers of n 
n A 3 


1 

1.11111111 
1 .22222222 
1.33333333 
1 .44444444 

1 .55555556 
1 .66666667 

1.77777778 
1.88888889 

2 


1.11111111 
1 .22222222 
1 .33333333 
1 .44444444 
1 .55555556 
1 .66666667 

1 .7777777 8 
1 .88888889 
2 


1 

1 .23456790 
1 .49382716 

1 .77777778 
2.08641975 
2.41975309 

2.77777778 
3.16049383 
3.56790124 
4 


1 

1 .37174211 
1 .82578875 
2.37037037 
3.01371742 
3.76406036 
4.62962963 
5.61865569 
6.73936900 
8 


Figure 15-3 


Press ♦ to return to the Table Sheet. 

Now make the table horizontal. Move the cursor to the Vertical 
or Horizontal field and type H. 

Type the Action command (!). The screen should look like Fig- 
ure 15-4. 

A horizontal table may use more space across the screen than a 
vertical table. There are ten values in each of these lists, but if you 
count the number of values on the screen, some are missing. 

To see the rest of the table, type ♦ . If the table requires a third 
page, type ♦ again. This is necessary only when displaying the 
table on the screen. The printer automatically prints out the re- 
quired number of pages for the entire table. 

Again, press ♦ to return to the Table Sheet. 

Note: If you merge two or more files that have common infor- 
mation on the Plot or Table Sheet, the common information is 
duplicated. 
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Powers of n 


List n 1 
n A 1 1 
n A 2 1 
n A 3 1 


1 .11111111 
1.11111111 
1 .23456790 
1 .3717421 1 


1 .22222222 
1 .22222222 
1 .49382716 
1 .82578875 


1 .33333333 1 
1 .33333333 1 
1 .77777778 2 
2.37037037 3 


Figure 15-4 

Plot and Table with TRAVEL3 

Now that you’ve worked with the Plot and Table Sheets, try using 
them with the lists in TRAVEL3. 

Reset the program and load the TRAVEL3 model. 

The two lists currently associated with TRAVEL3 are the list for 
mileage, mlg , and the list for speed, 6. 

Display the Plot Sheet in a single window and set up a plot titled 
Mileage related to Speed with the scale values turned off. Specify 
the x-axis as the list mlg and the .y-axis as the list s. Type the Ac- 
tion command (! ). 

The screen should look like Figure 15-5. 
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Figure 15-5 
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+ + 

Mileage related to Speed 



Return to the Plot Sheet by typing ♦ . 

Display the Table Sheet and set up a vertical table, titled Speed 
and Mileage, showing the same two lists, mlg first and then 5 , in 
columns 8 characters wide beginning with the third value on each 
list. Give mlg the heading Mileage and s the heading Speed . Type 
the Action command (!). 

The screen should look like Figure 15-6. 
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Speed and Mileage 


Mi leage 

Speed 

20 

18.87822 

25 

24.25813 

30 

30.62755 

35 

40.12852 

40 


45 



Figure 15-6 


Return to the Table Sheet by pressing ♦ . If you save TRAVEL3 
now, the plot and table settings will be saved as part of the model. 


Conclusion 

This chapter has shown you how to create plots and tables using 
the Plot and Table Sheets. The next chapter describes how to cre- 
ate and use your own functions. 


15-10 


TKiSolver Instruction Manual 


Chapter 1 6 User Functions 

• Functions 

• Function syntax in the TKiSolver program 

• The User Function Sheet 

• Creating a function 

• The User Function subsheet 

• The Storage command (/S) — Save Function option (F) 

• Applying TKiSolver user functions 

• Interpolation 

The TKiSolver program provides many built-in functions, such 
as SIN, PI, and APPLY, but you can also use your own functions. 
You can create functions, using lists for both the domain and the 
range, by entering particulars on the User Function Sheet. Three 
types of mapping are available: Table, Linear, and Step. Once a 
function has been created, it can be used in expressions and for 
plots and tables. 

This chapter describes what a function is and explains how to use 
the User Function Sheet to define your own functions and to de- 
fine other relationships between lists. It also shows you how to 
make plots and tables with a user function. See the Reference 
Manual for details about the TKiSolver built-in functions. 


To begin this chapter: 

Reset the program. 

Functions 

This section of the chapter contains a brief discussion about what 
a function is. If you know what functions are, you may want to 
skip the next few paragraphs. 

A function is a relationship between two sets of values. The two 
sets are called the domain and the range. Each element in the do- 
main is paired with one, and only one, element in the range. This 
relationship is arbitrary and may be as simple as a- b. 
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For example, look at the sets of values below. The relationship 
between the sets of values in Example 1 defines a function, but 
the relationship shown in Example 2 does not. 


Example 1 

domain range 
Set A Set B 

1 2 

2 5 


Example 2 

domain range 

Set X Set Y 








9 

5 


In Example 1, each element of the domain, Set A, has a unique 
match with an element in Set B, the range. Elements in the range 
may be associated with more than one value in the domain. 

In Example 2, each element of the domain, Set X, is matched 
with more than one element in the range, Set Y. Example 2 is not a 
function because each element in the domain is not matched 
uniquely with an element in the range. 


Function Syntax and Evaluation 

There are many different types of functions and many different 
ways to express them. Below is a common syntax for expressing 
functions. This is the syntax used by the TKISolver program: 



f(x)=y 



function name \ function value 


argument 


The function name identifies the function, and, like variable and 
list names, it must begin with a letter and may contain only let- 
ters, numbers, and the special characters @, #, $, %, and . 
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The argument is a value from the domain; the function value is a 
value from the range. The argument and function values can be 
any TKISolver expression, including symbolic values. If you use 
a symbolic value, it must begin with an apostrophe (’) so that the 
program recognizes it as a symbolic value. 

The TKISolver program uses this syntax for both built-in func- 
tions and user functions. 

A function typically evaluates the argument (domain value), re- 
turning the function value (range value). It sometimes can be use- 
ful to invert this relationship and evaluate the function value, 
returning the related domain value. When an inversion is possi- 
ble, the function is said to have an inverse. If values in the range 
are associated with more than one domain value, this inverse rela- 
tionship cannot occur. 

The User Function Sheet 

Change the screen to one window, and then select the User Func- 
tion Sheet by typing: 

= F 

The screen should look like Figure 16-1 . 

(In) Name: 

==================== USER FUNCTION SHEET =========== 

Name Domain Mapping Range Comment 


Figure 16-1 
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The User Function Sheet lists the user functions and displays 
some of their characteristics. 

The Name field displays the name of the user function, and the 
Domain field displays the name of the list used for the domain 
values. The Mapping field, an option field, shows the type of re- 
lationship between the domain and the range used in the func- 
tion. The Range field contains the name of the list used for the 
range values. 

Creating a Function 

You can create different types of functions using the User Func- 
tion Sheet. The examples in this section are of three typical types 
of functions: 

• A discrete function — one that has a finite number of argu- 
ments and values. 

• A linear function — one that takes the form a*x+ b-y. 

• A step function— one that associates an interval of domain 
values with a constant. 

First you will create the discrete function disf. The function disf 
will relate the symbolic and alphabetic representations of a set of 
numbers. 

Enter the function name disf in the first field of the Name col- 
umn. The Mapping field in this row automatically displays the 
value Table. Table is the default value for this field and is dis- 
played when a function is named. The Mapping field has three 
options — Table, Step, and Linear — entered by typing the initial 
letter of the mapping. These options are discussed as they are en- 
countered throughout this chapter. The default option, Table, is 
the one used for the function disf. 

The Table option matches elements within the two associated 
lists, element for element. Only the explicit values in the domain 
and range lists can be argument and function values. There is no 
interpolation. 

Enter a as the name of the Domain List and number as the name 
of the Range list. Enter discrete function in the Comment field. 

The screen should look like Figure 16-2. 
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(1 c) Comment: discrete function 


Name Domain 


d i s f a 


USER FUNCTION 
Mapping Range 


Table numbe r 


SHEET == = = = 
Comment 


discrete funct 


Figure 16-2 


The User Function Subsheet 

Like the Variable and List Sheets, the User Function Sheet has 
subsheets. Dive to the User Function subsheet for disf by typing 
the Dive command (>). 

A User Function subsheet is similar in appearance to a List sub- 
sheet, although its purpose is different. The four fields at the top 
of the sheet contain items from the Comment, Domain, Map- 
ping, and Range fields on the User Function Sheet. The rest of 
the sheet contains the element numbers and values for the two 
lists that make up the domain and range of the function. 

The columns labeled Domain and Range contain the values used 
for the function. Lists can be created by entering values here, but 
the lists must be named before values can be entered. (You named 
the lists when you entered them on the User Function Sheet.) As 
on a List subsheet, the Element column contains the element 
number of the corresponding values. The program generates the 
element number automatically when a value is entered in one of 
the lists. As you can see, the cursor moves automatically to the 
first field in the column labeled Domain. 
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On a User Function subsheet, the Action key (!) calls the Fill List 
feature. Enter a list of five values from 10 to 50 for the domain 
list a. 

The values for the range of the function disf are symbolic values, 
so you must type an apostrophe before the value. Enter these 
values for the range list number : 

Element Range Value 

1 ’twenty 

2 ’forty 

3 ’sixty 

4 ’eighty 

5 ’one hundred 

Before going on, you need to save this function, because it is used 
later in an example. To do this, use the Save Function (F) option 
of the Storage command (/S). This option saves the current User 
Function Sheet and User Function subsheets. Type: 

/ S F 

As for all the other Storage command (/S) options, you are 
prompted for a filename: 

Function Save: Filename: 

Enter the filename DISF, and the program saves the function. 

Return to the User Function Sheet. Delete the function disf from 
the User Function Sheet by deleting the row that contains the 
functions. Use the Delete command (/D). 

The two other functions to be used as examples are stored on the 
Instruction diskette in the file FUNC. Load the file FUNC. The 
screen should look like Figure 16-3. The names of the two new 
functions, linear f and step/, indicate the type of functions they 
are. 
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(In) Name: linear 


Name Domain 


l i nea r f c 
stepf c 


== USER FUNCTION 
Mapping Range 


Linear d 
Step e 


SHEET ==== 
Comment 


linear functio 
step function 


Figure 16-3 

Tables and Plots of Functions 

One way to describe the relationship between a domain and range 
expressed as a function is by looking at tables and plots of the 
functions. You can do this with the Table and Plot Sheets. This 
section looks at the two new functions, linear/ and stepf , using 
tables and plots. 

Step functions associate an interval of domain values with a con- 
stant. Linear functions associate range and domain values using 
the equation below, with x representing the domain value, y the 
range value, and a and b the constants defining the relationship 
between the domain and range: 

a *x + b = y 

To show the plot of a function or make a table of its values, use 
the lists that are the domain and range of the function. Notice 
that the two sample functions use the same list for the domain. 

Display the Table Sheet in the window in place of the User Func- 
tion Sheet, then enter the title Functions and the domain and 
range lists for the two functions as shown below. Because they 
share a common domain list, you need to enter that list only once. 
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List 

Width 

First 

Header 

c 

10 

1 

Domain 

d 

15 

1 

Linearf Range 

e 

15 

1 

Stepf Range 


Display the table by typing the Action key (! ). Your screen should 
look like Figure 16-4. 

Func t i ons 


Domain 

Linearf Range 

Stepf Range 

10 

20 

20 

12 

24 

20 

14 

28 

20 

16 

32 

20 

18 

36 

20 

20 

40 

40 

22 

44 

40 

24 

48 

40 

26 

52 

40 

28 

56 

40 

30 

60 

60 

32 

64 

60 

34 

68 

60 

36 

72 

60 

38 

76 

60 

40 

80 

80 

42 

84 

80 

44 

88 

80 


Figure 16-4 

As you can see, for every value in the domain there is a different 
value under Linearf Range, but the values under Stepf Range are 
constant for intervals of several elements in the domain. 

Type ♦ to see the second page, then return to the Table Sheet by 
typing ♦ again. 

Both linear and step functions take their names from the graphs 
which represent them. Let’s look at the plot for the linear func- 
tion first. 

Display the Plot Sheet and enter the title Linear Function . Enter 
the lists c for the x-axis andd for the j-axis, then display the plot 
by typing the Action key (1 ). 


TKISolver Instruction Manual 


As you can see, the plot is essentially a straight line, hence a linear 
function. Because of the way the TKISolver program displays 
graphs, there are slight variations from expected plots, such as 
the slight bends seen in the example. 

Type ♦ to return to the Plot Sheet and set the plot for step / using 
the same method. Change the title to Step Function , delete the list 
d from the Y-axis field, and enter the list name e instead. Type the 
Action key. This time the plot shows plateaus that look like the 
outline of a set of steps. 

Type ♦ to return to the Plot Sheet. 

If you want to compare two or more functions on one plot, you 
can do so only if they use the same domain. This can be done with 
the two sample functions by adding the list d to the Plot Sheet in a 
Y-axis field and changing the plotting character for one of them. 

Using User Functions 

This section shows you how to use User Functions, with the three 
functions disf, linear / , and step f as examples. Display the User 
Function Sheet and load the file disf so that all three functions 
are again present on the User Function Sheet. The list used for the 
domain in function disf can be used to show the functions linear f 
and step f more clearly. 

The domain for the three functions is 10 through 50, but the lists 
used, a and c, have slightly different forms; a has only five values 
and c has 21. For this example, we will use the shorter form. 

Change the domain for both linear/ and step/ to a by changing 
the list name in their domain fields. Dive to the subsheet for 
linear / , move the cursor to the Range column, and dive again so 
that the List subsheet for d is displayed. Use the Delete command 
(/D) with the Goto command (:) to delete the values in the list, 
and use the Action command (!) to enter five new elements with 
the values 20 to 100. 

Type the Return command «) twice to return to the User Func- 
tion Sheet, then repeat the above procedure to change the range 
values for step f. You have not actually changed the extent of the 
range for either function because the mapping remains the same. 
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Now all the lists have five elements, the three functions have the 
same domain, and linear/ and step/ have the same range. The 
model given below uses all three functions. 

Display the Variable and Rule Sheets on a split screen with the 
Variable Sheet in the top window and the Rule Sheet in the bot- 
tom window. Enter the following three rules: 

disf(a)=b 
L i nea r f ( a ) =d 
s t epf ( a ) =e 

Give the variable a a value of 20 and solve the model. The screen 
should look like Figure 16-5. The output values for the variables 
d and e are the same, even though the mapping of the two func- 
tions is different. In their current forms, there is no difference 
between the functions linear/ and step/ when their domain 
values are limited to explicit values in the lists. In the section be- 
low on interpolation, you will see these two functions behaving 
differently. 

( 1 i ) I nput : 20 


St Input Name 

20 a 

b ‘forty 

d 40 

e 40 


====================: rule SHEET ==================== 

S Rule 

d i s f C a ) =b 
l i nea r f ( a ) =d 
s t epf ( a ) =e 


= ==== VARIABLE SHEET = = = = = = = = = = = = 
Output Unit Comment 


Figure 16-5 
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User functions can also be solved as inverses. Reset the variable 
values. Because all three functions have the same domain, you 
can solve for all their inverses simultaneously. 

Enter the value ’sixty for variable b, and the value 60 for both 
variables d and e. Solve the model. The domain for all is the 
same, so there is no conflict in finding a and all three equations 
have been satisfied. 

Interpolation 

Interpolation is a way of estimating a value between two known 
values of a function’s range or domain. The Mapping field on the 
User Function Sheet shows the type of interpolation used for the 
function. 

The Table option is for functions that do not require interpola- 
tion. Using this option, the function operates with only the values 
that have actually been entered on the domain and range lists, 
using them like a table of values. 

The Linear option interpolates proportionally, finding values be- 
tween the given values. 

The Step option interpolates like a step function, returning a con- 
stant for a given interval of domain values. 

This example shows interpolation. Reset the variable values. 

The three functions use the three mapping options. Because disf 
uses table mapping, it will not be used for interpolation, so delete 
the first rule, the one using disf, from the Rule Sheet. 

Give variable a an input value of 25 and solve the model. The 
screen should look like Figure 16-6. 

The value for d was found using linear interpolation by solving 
this proportion for x : 

Domain Values Range Values 

25 _ * 

30 60 


The values used in this equation are the corresponding elements 
in the domain and range. 
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C 1 i ) Input: 2 5 

==================== VARIABLE SHEET ============ 

St Input Name Output Unit Comment 

25 a 

b 

d 50 

e 40 


==================== rule SHEET 

S Rule 

l i nearf (a) =d 
stepf(a)=e 


Figure 16-6 

The value for variable e was found using step mapping and is the 
range value for the domain interval from 20 to 30. 

TK! Solver interpolation assumes that no more than two contigu- 
ous values are used for interpolation. This means that when you 
set up functions, you must enter the range and domain values in 
ascending or descending order, otherwise the interpolation will 
not be what you might expect. 

For more details, please consult the Reference Manual. 

Applying TKiSolver User Functions 

Now let’s look at the mortgage and travel models to see how 
functions can be applied. Reset the program. 

User Functions with MORTGAGE 

In Chapter 13 you created two lists for the mortgage model to 
be used with functions. These lists were /, containing interest 
rates, and B , containing bank names. In this example, these two 
lists are used to create a function that compares the interest rates 
associated with each bank. 
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Load the mortgage model and reset the variable values. The 
Variable Sheet should be in a single window. 

You are shopping for a 25-year mortgage on a $97,000 house with 
15% down, and you want to compare the interest rates offered by 
several banks. 

The list associations have remained. In this example, the vari- 
ables / and A use lists. Disassociate the list for dp by typing L in 
the Status field. 

In this example, the list / will be associated with the variable /. 
When a list is used for either the domain or range of a user func- 
tion, and that list is associated with a variable, and the variable 
and list both have units, the Calculation unit of the variable and 
the Display unit of the list must be the same. 

Split the screen, displaying the List Sheet in the bottom window, 
and dive to the List subsheet for the list /. Change the Display unit 
to monthly rate so that it is the same as the Calculation unit for 
the variable /. 

With the User Function Sheet in the top window, create the func- 
tion bank with list B as the domain and list i as the range using 
Table mapping. This function takes bank names as arguments 
and returns interest rates. 

Because the program identifies the function by the function 
name, the arguments and function values used in a rule do not 
have to be the list names of the domain and range but can be any 
variable or list name. The following rule uses the function bank 
with the argument bank name. With the Rule Sheet in the bot- 

tom window, enter the new rule: 

bank(bank_name)=i 

Change the display to a single window containing the Variable 
Sheet so that you can see all the variables. Enter the values from 
the problem shown above along with the symbolic value 
’First National for bank name . 

The variables / and A will have output values in lists i and A, re- 
spectively. The variable bank name is associated with the input 

list B. You must dive to the Variable subsheet for bank name to 

name the associated list, B. 
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Redisplay the Variable Sheet. The screen should look like Fig- 
ure 16-7. Solve the model using the List command (/L). 

(10i) Input: ' F i r s t _Na t i ona l 


St Input 

Name 

Output 

Unit 

Comment 

97000 

H 


dollars 

House price 


d 


dollars 

Down paymen 

15 

dp 


percent 

Down paymen 


P 


dollars 

Mortgage 

25 

n 


years 

Term 

L 

i 


percent 

Interest ra 

L 

A 


dot l a r s 

Monthly pay 


T 


dollars 

Total of pa 


T i p 


dollars 

Total inter 


L 'First Na bank_na 


Figure 16-7 

Look at the results by making a table of the lists /, A , and B. Save 
the model MORTGAGE. 

User Functions with TRAVEL 

In the last few chapters, the different versions of the TRAVEL 
model have been used for a hypothetical car. Now we will modify 
the TRAVEL2 model to accommodate three different types of 
car — economy, midsize, and sedan. The functions show how the 
type of car affects the gas mileage. 

On a 500-mile trip, how do the mileage and cost compare for the 
three different types of cars if they are driven at 40 miles per 
hour? 

You will use the List command (/L) for this problem. Reset the 
program and load the file TRAVEL2, then load the file TFUNC that 
contains the four functions needed for this problem. Reset the 
variable values. 
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Display the User Function Sheet in the top window. The first 
three functions, econo , mid , and sedan , associate speed and mile- 
age for each type of car. 1 The remaining function, car ; selects the 
type of car used to solve the model. 

This problem requires two new rules to determine mileage as a 
function of car type. Display the Rule Sheet in the bottom win- 
dow, then add the two new rules to those already on the sheet: 

car(type)=ty 
app l y ( t y , s ) =m l g 

The first equation uses the function car with Table mapping to 
identify the type of car you want to solve the model for. In the top 
window, dive to the User Function subsheet for car. 

As you can see, the range for car comprises the names of the three 
functions that determine mileage. The value for the variable type 
must be ’E, ’M, or ’S, so that the function car can select the func- 
tion to be used for the solution. 

The second new equation uses the built-in function apply to asso- 
ciate the car type with the function that has been selected to deter- 
mine mileage. The built-in function apply has the syntax: 

APPLY (function name , domain value) 

It searches for the function named and evaluates that function 
for the given domain value, returning the appropriate range 
value. 

In the equation above, the value for the variable ty is the name of 
the function to be evaluated. The variable s is the argument of the 
selected function. 

Because this problem uses these two rules, the two old rules used 
to determine mileage should be deleted. Delete the rules: 

gas=t ★power 
f + ( w* s A 3 ) =powe r 

Change the screen to one window and display the Variable Sheet 
so that you can see all the variables. Notice that although the 

1 The values used for these functions are taken from United States Environmental 
Protection Agency publication 460/3-80-010 on Passenger Car Fuel Economy, 
September 1980. 
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rules containing the variables power , /, and w were deleted, the 
variable names are still on the Variable Sheet. If you want to save 
this version of the travel model, name it travels 

Because we want to examine how the mileage for the three types 
of cars affects cost, we will solve the model using the List com- 
mand (/L). 

Enter the input values for the variables shown below and solve 
the model: 


Value 

500 mi 
40 mi/h 

$1.29 

’M 


Variable 

d 

s 

pr 

type 


Associate the variables ty, mlg , and cost with output lists. Associ- 
ate the variable type with the input list /, which contains the 
values ’E, ’M, and ’S, by changing the name of the associated list 
on the subsheet for the variable type . 

Display the Variable Sheet again. The screen should look like Fig- 
ure 16-8. 


<1 1 s) Status : 

: List 






VARIABLE 

SHEET = = = == 

it 

H 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

St Input 

Name 

Output 

Uni t 

Comment 

L 

mlg 


mi /ga l 

mi l e a g e 

500 

d 


mi 

d i stance 


gas 


ga l 

amount of g 

40 

s 


mi/h 

speed 


t 


h 

time 

L 

cost 


$ 

cost of t r i 

1 .29 

pr 


$ 

price of ga 


power 


hp 

energy comp 


f 


hp 

internal fr 


w 


hp* h A 3 /m i 

wind resist 

L *M 

type 




L 

ty 





Figure 16-8 
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Solve the model using the List command (/L). To see the results, 
set the Table Sheet to show a table of the lists ty 9 mlg , and cost . 

To see how speed affects the results, solve the model with a differ- 
ent value, or a list of values, for s. Remember to rename the cur- 
rent lists if you want to save the current values. 

Conclusion 

This chapter has discussed user functions, what they are, and 
how to use and apply them. The next chapter is a summation of 
the TKISolver Instruction Manual. 
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Chapter 1 7 Summation 

This is the last chapter in the Instruction manual. You have used 
and created several models throughout this manual. While work- 
ing with these models, you have used most of the features of the 
TK! Solver program. The models you develop may not evolve 
into complex models like the travel model did, but the quality 
of a model is based on its utility, not its size or complexity. The 
travel model, for example, grew to accommodate and demon- 
strate the various features of the program. You may find instead 
that many of your models require no more than the Variable, 
Rule, and Unit Sheets. 

TK! Solver models are more than a mathematical statement of a 
problem. These models introduce a new dimension to the 
problem-solving process. Before the TK! Solver program was 
available, it was difficult to formulate problems that required a 
solution for more than one variable or instance. TK! Solver 
models allow you to easily manipulate all the variables of the 
problem, solving immediately for a variable or combination of 
variables. 

A model begins with the statement of a problem in terms of the 
relationships of variables involved in that problem. These rela- 
tionships can be explored in many ways — by changing input 
values, by changing the relationships of the variables, by refining 
and expanding the rules, by changing units, by experimenting 
with and comparing lists of values — by altering and stipulating a 
variety of conditions. 

The equations used in building models for the TK! Solver pro- 
gram can be entered as they are formulated. They do not need 
any special formulation, nor do they need to be entered in a spe- 
cific order, and you can change the units associated with any vari- 
able without having to alter an equation. 

As you use the TK! Solver program with your own models to solve 
your own problems, you will find shortcuts and develop special 
ways of using the program that will mold it to your specific needs. 

The building and expansion of travel is an example of how a 
model can be created to express a problem and refined to explore 
the possibilities of other problems related to the same variables. 
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The first version of the travel model that you used was a simple 
one expressing relationships between speed, distance, time, and 
cost. This model was expanded by adding two new equations to 
look more closely at the way mileage was affected by mechanical 
factors in a hypothetical car. By adding unit conversion defini- 
tions, input and output values could be used in any chosen unit. 

More use was made of the TKISolver features as you explored the 
effects of changes made to the hypothetical car. The use of lists 
gave the advantage of multiple answers to multiple input possibil- 
ities. The use of functions enabled you to interrelate variables so 
that the model could be used with a wide range of input values. 

The TKISolver program helps you to explore solutions to prob- 
lems in a more flexible environment than has ever been possible. 
Now that you have learned how to use the program, you can be- 
gin to define and construct your own models. The TKISolver 
package includes a Reference Card, a Help Facility, and a Refer- 
ence Manual, all of which can be used to find answers to ques- 
tions that may arise while you are using the program. 

To complement the TKISolver program, Software Arts, Inc. has 
developed a line of TKISolverPacks, packages of models for spe- 
cific applications. These are available for many fields, interests, 
and needs. 

Each TKISolverPack contains a variety of complete models for a 
specific application, and you can modify and personalize these 
models to fit your requirements. Now that you are familiar with 
the TKISolver program, you may want to use the TKISolverPack 
that best applies to your specific needs. TKISolverPacks are 
available from software dealers. 

Software Arts, Inc. supports users of the TKISolver program 
with the publication TKISATN, the journal for TKISolver users. 
For more information, write to: TKISATN Information, Soft- 
ware Arts, Inc., 27 Mica Lane, Wellesley, MA 02181. 
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